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C++ is a flexible, powerful programming language with hundreds of 
thousands of applications. However, the knowledge of how to take 
advantage of its full potential comes only with time and experience. 
That's where this book comes in. Think of it as a "cookbook" for solving 
your programming problems, much as The Joy of Cooking is a guide to 
solving your dinner dilemmas. 

C++ Timesaving Techniques For Dummies is a book for the beginning-to- 
advanced C++ programmer who needs immediate answers to the prob- 
lems that crop up in the professional software-development world. I 
assume that you have prior programming experience, as well as experi- 
ence specifically with the C++ programming language. "Fluff" — like dis- 
cussions of looping structures or defining variables, or the basics of 
compiling applications — is kept to a minimum here. Instead, I offer 
quick, step-by-step instructions for solving specific problems in C++. 

Each technique includes example code — which you are welcome to use 
in your own applications, or modify as you see fit. This is literally a case 
of "steal this code, please." C++ is a language that lends itself well to 
component-based design and implementation. This means that you can 
take a piece from here and a piece from there to implement the solution 
that you have in mind. 

C++ Timesaving Techniques For Dummies is not an operating-system- 
specific (or even compiler-specific) book. The techniques and code that 
you find here should work on all compilers that support the standard 
C++ language, and on all operating systems for which a standard com- 
piler exists. This book is intended to be as useful to the Unix programmer 
as to the Microsoft Windows programmer, and just as useful for program- 
ming with X-windows as it is for .Net. 

My goal in writing this book is to empower you with some of the stronger 
features of C++, as well as some great tips and methods to solve everyday 
problems, without the headaches and lost time that go with trying to fig- 
ure out how to use those tools. C++ provides simple, fast, powerful solu- 
tions to meet the demands of day-to-day programming — my goal is to 
save you time while making the tools clear and easy to use. 
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[For Dummies books focus 
^<J,njP<fu\s^at save you time, either 
onthe spot or somewhere down the road. And these 
books get to the point in a hurry, with step-by-step 
instructions to pace you through the tasks you need 
to do, without any of the fluff you don't want. I've iden- 
tified more than 70 techniques that C++ programmers 
need to know to make the most of their time. In addi- 
tion, each technique includes code samples that make 
programming a breeze. Decide for yourself how to use 
this book: Read it cover to cover if you like, or skip 
right to the technique that interests you the most. 

In C++ Timesaving Techniques For Dummies, you can 
find out how to 

Reduce time-consuming tasks: I'm letting you in 
on more than 70 tips and tricks for your C++ sys- 
tem, so you can spend more time creating great 
results and less time fiddling with a feature so 
that it works correctly. 

v* Take your skills up a notch: You're already famil- 
iar with the basics of using C++. Now this book 
takes you to the next level, helping you become a 
more powerful programmer. 

v* Work with the basics of C++ to meet your needs: I 

show you how to bend the fundamentals of object- 
oriented programming and the pre-processor so 
that your programs work faster and more reliably. 

Improve your skills with types, classes, arrays, 
and templates: Fine-tuning your abilities with 
these elements will improve your programs' 
functionality and make your code more readable. 

Understand the finer points of input and output: 

Improving the way you work with input and out- 
put will reduce memory loss and increase speed. 

Use built-in functionality and utilities: Gaining 
familiarity with these features will help you get 
the most out of what C++ already offers. 

l> Improve your debugging skills: Getting better at 
debugging will speed up the whole programming 
process. 



What's Available on the 
Companion Web Site) 

The companion Web site for this book contains all 
the source code shown for the techniques and exam- 
ples listed in this book. This resource can save you 
considerable typing when you want to use the code 
in your own applications, as well as allowing you to 
easily refer back to the original code if you modify 
the things you find here. You can find the site at 
www. dummi es.com/go/cpluspluststfd. 

Obviously, in order to utilize the code in the book, 
you will need a C++ compiler. The code in this book 
was all tested with the GNU C++ compiler, a copy of 
which you will find on the GNU organization's Web 
site: www .gnu.org. This compiler is a public-domain 
(read: free) compiler that you can use in your own 
development, or simply to test things on computers 
that don't have a full-blown commercial develop- 
ment system. The GNU C++ compiler contains all the 
standard header files, libraries, debuggers, and 
other tools that C++ programmers expect. 

If you already own another compiler, such as Visual 
Studio, Borland's C++Builder, or another compiler, 
hey, no worries. The code you find here should work 
with any of these compilers, as long as you follow 
the standards for defining header files and including 
code libraries. 

Contentions Used in This Book 

When I describe output from the compiler, operating 
system, or application you're developing, you will 
see it in a distinctive typeface that looks like this: 

This is some output 

Source-code listings — such as the application 
you're developing and feeding to the compiler to 
mangle into executable code — will look like this: 
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Listing 



— ^ r^ r ^ intii=0; 

Dr op Books 



// This is a 1 oop 

i<10; ++i ) 
is line %d\n" 



i ); 



If you are entering code by hand, you should enter it 
as you see it in the book, although spaces and blank 
lines won't matter. Comments can be skipped, if you 
so choose, but in general, the code is commented as 
it would be in a production environment. 

In general, the code and text in the book should be 
quite straightforward. The entries are all in list 
format, taking you step by step through the process 
of creating source files, compiling them, and 
running the resulting application. The code is all 
compiler-agnostic — that is, it doesn't indicate 
(because it doesn't know) the specific compiler 
commands you will use for the compiler you have on 
your machine. Please refer to your compiler's docu- 
mentation if you have specific questions about the 
compilation and linking process for your specific 
compiler or operating system. 

What's In This Book 

This book is organized into parts — groups of tech- 
niques about a common subject that can save you 
time and help you get your program written fast and 
running better. Each technique is written to be inde- 
pendent of the others; you need only implement the 
techniques that benefit you and your users. 

Part I: Streamlining the Means and 
Mechanics of OOP 

In this part, you learn the basic concepts of object- 
oriented programming and how they apply to the 
C++ programming language. 



Part II: Working with the Pre-Processor 

The C++ pre-processor is a powerful tool for cus- 
tomizing your application, making your code more 
readable, and creating portable applications. In this 
section, you get some handy ways to wring the most 
out of the pre-processor; some handy techniques 
explain how to create portable code, and the voice 
of experience reveals why you should avoid the 
assert macro. 

Part III: Types 

The C++ language is rich in data types and user- 
definable types. In this section, we explore using the 
built-in types of the language, as well as creating 
your own types that can be used just like the built-in 
ones. You find techniques in this section that explain 
structures and how you can use them. You also zero 
in on enumerations and creating default arguments 
for methods. 

Part IV: Classes 

The core of the C++ programming language is the 
class. In this section, you get a look at how to create 
complete classes that work in any environment — as 
well as how to perform data validation and manipu- 
lation, create properties for your class, and inherit 
from other people's classes. 

Part V: Arrays and Templates 

Container classes are a core element of the Standard 
Template Library (STL), an important part of the C++ 
programming environment. In this section, you get 
the goods on working with the various container 
classes, as well as creating your own containers. 
Here's where to find out how to iterate over a collec- 
tion of objects, and how to allocate and de-allocate 
blocks of objects. 
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Part VI: Input and Output 

It woul d be a rare program indeed that did not have 
k flnJ oHn»at lad^tput. After all, why would 
gram that could not be 
controlled in some way, or at least yield some sort of 
useful information? In this section, we learn all about 
various forms of input and output, from delimited 
file input to XML file output, and everything in 
between. 

Part VII: Using the Built-in Functionality 

One hallmark of the C++ programming language is 
its extensibility and reusability Why reinvent the 
wheel every time you write an application? C++ 
makes it easy to avoid this pitfall by providing a ton 
of built-in functionality. In this section, you get to 
use that built-in functionality — in particular, the 
C++ library and STL — to implement a complete 
internationalization class. You also get pointers on 
avoiding memory leaks, using hash tables, and over- 
riding allocators for a container class. 

Part VIII: Utilities 

The single best way to learn C++ techniques is to 
look at the way that other people implement various 
things. This section contains simple utilities that can 
sharpen your coding techniques, and it provides 
valuable code that you can drop directly into your 
applications. You will find techniques here for 
encoding and decoding data, converting data into a 
format that the World Wide Web can understand, 
and opening a file using multiple search paths. 

Part IX: Debugging C++ Applications 

One of the most important things to understand 
about programs is that they break. Things go wrong, 
code behaves in unexpected ways, and users do 
things you (and sometimes they) didn't intend. 



When these things happen, it is extremely important 
that you understand how to track down the issues in 
the code. In this section, you learn valuable tech- 
niques for creating tracing macros, tracking down 
memory leaks, and checking for errors at run-time. 

Part X: The Scary (or Fun!) Stuff 

This part contains techniques to help you take con- 
trol of the complexity of your code, and ways you 
can avoid being intimidated by convoluted code you 
might run into while working. Not being afraid of 
your code is the number-one area of importance in 
programming; this section will aid you in that 
endeavor. 

Icons Used in This Book 

Each technique in this book has icons pointing to 
special information, sometimes quite emphatically. 
Each icon has its own purpose. 



When there's a way to save time, either now 
or in the future, this icon leads the way. Home 
in on these icons when every second counts. 

This icon points to handy hints that help you 
work through the steps in each technique, or 
offer handy troubleshooting info. 

These icons are your trail of breadcrumbs, 
leading back to information that you'll want to 
keep in mind. 

When you see a Warning icon, there's a 
chance that your data or your system is at risk. 
You won't see many of these, but when you 
do, proceed with caution. 
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The dictionary defines encapsulation as "to encase in or as if in a 
capsule" and that is exactly the approach that C++ uses. An object 
is a "capsule" and the information and processing algorithms that 
it implements are hidden from the user. All that the users see is the 
functional-level interface that allows them to use the class to do the job 
they need done. By placing the data within the interface, rather than 
allowing the user direct access to it, the data is protected from invalid 
values, wrongful changes, or improper coercion to new data types. 
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Most time wasted in application development is spent changing code 
that has been updated by another source. It doesn't really add any- 
thing to your program, but it does take time to change things when 
someone has modified the algorithm being used. If you hide the algo- 
rithm from the developer — and provide a consistent interface — you 
will find that it takes considerably less time to change the application 
when the base code changes. Since the user only cares about the data 
and how it is computed, keeping your algorithm private and your 
interface constant protects the data integrity for the user. 



Creating and Implementing 
an Encapsulated Class 

Listing 1-1 presents the Stri ngCodi ng class, an encapsulated method of 
encryption. The benefit of encapsulation is, in effect, that it cuts to the 
chase: The programmer utilizing our Stri ngCodi ng class knows nothing 
about the algorithm used to encrypt strings — and doesn't really need to 
know what data was used to encrypt the string in the first place. Okay, 
but why do it? Well, you have three good reasons to "hide" the implemen- 
tation of an algorithm from its user: 

Hiding the implementation stops people from fiddling with the input 
data to make the algorithm work differently. Such changes may be 
meant to make the algorithm work correctly, but can easily mess it up; 
either way, the meddling masks possible bugs from the developers. 
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v* Hiding the algorithm makes it easy to replace the 
implementation with a more workable alternative 
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data. 



The following list of steps shows you how to create 
and implement this encapsulated method: 



f m In the code editor of your choice, create a new 
file to hold the code for the definition of your 
source file. 

In this example, the file is named chOl . cpp, 
although you can use whatever you choose. 

2, Type the code from Listing 1-1 into your file, 
substituting your own names for the italicized 
constants, variables, and filenames. 

Or better yet, copy the code from the source file 
included on this book's companion Web site. 



Listing 1-1: The StringCoding Class 


^include <stdio 
#include <strin 


.h> 

3> 








class StringCod 
I 


i ng 








private: 

// The key 
std : : stri ng 

publ i c : 

// The cons 
Stri ngCodi n 


to use in encrypting 
sKey; 


the string 






tructor, uses a pres 
g{ void ) 








{ 

sKey = 

} 


'ATest" ; 








// Main con 
Stri ngCodi n 
{ 


itructor, allows the user to sp 
j{ const char *strKey ) 


ecify a key 



if ( strKey ) 



sKey = strKey; 

else 

sKey = "ATest" ; 

} 

// Copy constructor 

Stri ngCodi ng( const Stri ngCodi ng& aCopy ) 
{ 

sKey = aCopy.sKey; 

} 

publ 1 c : 

// Methods 

std::string Encodet const char *strln ); 
std::string Decodet const char *strln ); 
private: 

std::string Xor( const char *strln ); 

) ; 
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std : : stri ng Stri ngCodi ng: :Xor( const char *strln ) 
f 

std : : stri ng sOut = " " ; 




<(int)strlen(strln) ; ++i ) 



char c = (strln[i] A s^ey[nlndex] ) ; 
sOut += c; 
nlndex ++; 

if ( nlndex == sKey.l ength( ) ) 
nlndex = 0; 

} 

return sOut; 

} 

// For XOR encoding, the encode and decode methods are the same. 
std::string Stri ngCodi ng: :Encode( const char *strln ) 

return Xor( strln ) ; 



std::string St ri ngCodi ng : :Decode( const char *strln ) 
return Xor( strln ) ; 



nt main(int argc, char **argv) 

if ( argc < 2 ) 

pri ntf( "Usage : chl_l inputstringl [i nputstri ng2 . . . ]\n" ) ; 
exit(l) ; 

} 

Stri ngCodi ng key ("XXX"); 

for ( int i=l; i<argc; ++i ) 
{ 

std::string sEncode = key.Encode( argv[i] ); 

pri ntf( " Input String : [%s]\n", argv[i] ); 

pri ntf( " Encoded String: [%s]\n", sEncode . c_str( ) ); 

std::string sDecode = key.Decode( sEncode . c_str( ) ); 

pri ntf( "Decoded String: [%s]\n", sDecode . c_str( ) ); 

} 

printf ( "%d strings encoded\n", argc-1); 
return 0; 
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3. Save the source code as a file in the code-editor 
application and then close the code editor. 




qui «y))fct}i yfrnfltter 



eted source code, using 
r on your favorite operat- 
ing system. 

S, Run your new application on your favorite 
operating system. 

If you have done everything properly, you should 
see the output shown here in the console window of 
your operating system: 

$ .7chl_l.exe "hello" 



Input String 
Encoded String 
Decoded String 



[hel 1 o] 
[0=447] 
[hel 1 o] 



1 strings encoded 

Note that our input and decoded strings are the 
same — and that the encoded string is completely 
indecipherable (as a good encrypted string should 
be). And any programmer using the object will never 
see the algorithm in question! 



Making Updates to an 
Encapsulated Class 

One of the benefits of encapsulation is that it makes 
updating your hidden data simple and convenient. 
With encapsulation, you can easily replace the 
underlying encryption algorithm in Listing 1-1 with 
an alternative if one is found to work better. In our 
original algorithm, we did an "exclusive logical or" 
to convert a character to another character. In the 
following example, suppose that we want to use a 
different method for encrypting strings. For simplic- 
ity, suppose that this new algorithm encrypts strings 
simply by changing each character in the input 
string to the next letter position in the alphabet: An 
a becomes a ft, a c becomes a d, and so on. Obviously, 
our decryption algorithm would have to do the exact 
opposite, subtracting one letter position from the 
input string to return a valid output string. We could 
then modify the Encode method in Listing 1-1 to reflect 
this change. The following steps show how: 

f m Reopen the source file in your code editor. 

In this example, we called the source file 

chOl . cpp. 

2, Modify the code as shown in Listing 1-2. 



Listing 1-2: Updating the StringCoding Class 



std::string Stri ngCodi ng : : Encode( const char *strln ) 
{ 

std : : stri ng sOut = " " ; 

for ( int i=0; i <( i nt ) stri en ( str In ) ; ++i ) 
{ 

char c = s t r I n [ i ] ; 
c ++; 

sOut += c; 

} 

return sOut; 



} 

std::string Stri ngCodi ng : : Decode( const char *strln ) 
{ 

std : : stri ng sOut = " " ; 
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for ( int i=0; i < ( i nt ) strl en ( str In ) ; ++i ) 
{ 

char c = s t r I n [ i ] ; 

DropBOaks 
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return sOut; 



3. Save the source code as a file in the code editor 
and then close the code editor. 

4. Compile the application, using your favorite 
compiler on your favorite operating system. 

5. Run the application on your favorite operating 
system. 

You might think that this approach would have an 
impact on the developers who were using our class. 
In fact, we can make these changes in our class 
(check out the resulting program on this book's 
companion Web site as chl_la . cpp) and leave the 
remainder of the application alone. The developers 
don't have to worry about it. When we compile and 
run this application, we get the following output: 

$ ./chl_la.exe "hello" 
Input String : [hello] 
Encoded String: [ifmmp] 
Decoded String: [hello] 
1 strings encoded 

As you can see, the algorithm changed, yet the 
encoding and decoding still worked and the applica- 
tion code didn't change at all. This, then, is the real 
power of encapsulation: It's a black box. The end 



users have no need to know how something works in 
order to use it; they simply need to know what it 
does and how to make it do its thing. 

Encapsulation also solves two other big problems in 
the programming world: 

By putting all the code to implement specific 
functionality in one place, you know exactly 
where to go when a bug crops up in that func- 
tionality. Rather than having to chase the same 
code in a hundred scattered places, you have it 
in one place. 

You can change how your data is internally 
stored without affecting the program external to 
that class. For example, imagine that in the first 
version of the code just given, we chose to use 
an integer value rather than the string key. The 
outside application would never know, or care. 

If you really want to "hide" your implementa- 
tion from the user — yet still give the end user 
a chance to customize your code — implement 
your own types for the values to be passed in. 
Doing so requires your users to use your spe- 
cific data types, rather than more generic ones. 
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The American Heritage Dictionary defines the term abstraction as 
"the process of leaving out of consideration one or more properties 
of a complex object so as to attend to others." Basically, this means 
that we need to pick and choose the parts of our objects that are impor- 
tant to us. To abstract our data, we choose to encapsulate those portions 
of the object that contain certain basic types of functionality (base 
objects) — that way we can reuse them in other objects that redefine 
that functionality. Such basic objects are called, not surprisingly, base 
classes. The extended objects are called inherited classes. Together they 
form a fundamental principle of C++. Abstraction in C++ is provided 
through the pure virtual method. A pure virtual method is a method in a 
base class that must be implemented in any derived class in order to 
compile and use that derived class. 



Virtual methods are one of the best timesavers available in C++. 
By allowing people to override just small pieces of your application 
functionality — without requiring you to rewrite the entire class — you 
give them the chance to extend your work with just a small amount of 
effort of their own. The concept of abstraction is satisfied through the 
virtual method because the base-class programmer can assume that 
later programmers will change the behavior of the class through a 
defined interface. Because it's always better to use less effort, using 
virtual methods means your code is more likely to be reused — leading 
to fewer errors, freeing up more time to design and develop quality 
software. 




Creating a Mailing-List Application 

This concept is just a little bit abstract (pardon the pun), so here's a con- 
crete example to show you how abstraction really works: Assume you 
want to implement a mailing list for your company. This mailing list 
consists of objects (called mailing-list entries) that represent each of the 
people you're trying to reach. Suppose, however, that you have to load 
the data from one of two sources: from a file containing all the names, or 
directly from the user's command line. A look at the overall "flow" of this 
application reveals that the two sides of this system have a lot in common: 
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To handle input from a file, we need some place to 
store the names, addresses, cities, states, and zip 
codes itam a file. To handle input from the command 
; ffT\of^ Ijafe^load that exact same data 
oVs/isad lirrevUfd store it in the same place. 
Tfien we need the capability to print those mailing-list 
items or merge them into another document. After 
the input is stored in memory, of course, we don't 
really care how it got there; we care only how we can 
access the data in the objects. The two different 
paths, file-based and command-line-based, share the 
same basic information; rather than implement the 
information twice, we can abstract it into a container 
for the mailing-list data. Here's how to do that: 



f m In the code editor of your choice, create a new 
file to hold the code for the definition of the 
class. 

In this example, the file is named ch02 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 2-1 into your file, 
substituting your own names for the italicized 
constants, variables, and filenames. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 2-1: The BaseMailingListEntry Class 



#include <string> 
#include <iostream> 
#include <stdio.h> 

class BaseMailingListEntry 



pri vate 






std 


: stri ng 


sFi rstName ; 


std 


: stri ng 


s LastName ; 


std 


: stri ng 


sAddress Li nel ; 


std 


: stri ng 


sAddress Li ne2 ; 


std 


: stri ng 


sCi ty ; 


std 


: stri ng 


sState ; 


std 


: stri ng 


sZi pCode ; 


publ i c : 







BaseMa i 1 i ngLi stEntry( void) 

f 

} 

BaseMai 1 i ngLi stEntryi const BaseMai 1 i ngLi stEntrylk aCopy ) 
{ 

sFirstName = aCopy . sFi rstName ; 
sLastName = aCopy . s LastName ; 
sAddress Li nel = aCopy . sAddress Li nel ; 
sAddress Li ne2 = aCopy . sAddress Li ne2 ; 
sCity = aCopy.sCity; 
sState = aCopy . sState ; 
sZipCode = aCopy . sZi pCode ; 



virtual bool First(void) 
virtual bool Next(void) 



0; // A pure virtual function 

0; // Another pure virtual function 



(continued) 
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Listing 2-1 (continued) 



II Accessors 




std 
std 
std 
std 



: s t r i n g 
: s t r i n g 
: s t r i n g 
: s t r i n g 



getFi rstName( ) 
fe^istName( ) 
eOldressH ) 

getAddress2 ( ) 
getCity ( ) 
getStatet ) 
getZi pCodet ) 



return sFi rstName ; } ; 

return sLastName ; } ; 

return sAddressLi nel ; 
return sAddress Li ne2 ; 
return sCi ty ; ) ; 
return sState ; ) ; 
return sZi pCode ; I ; 



void setFi rstName(const char *strFi rstName ) 
sFirstName = strFi rstName ; ); 

void setLastName(const char *strLastName ) 
sLastName = strLastName; }; 

void setAddressK const char *strAddressl ) 
sAddressLi nel = strAddressl; }; 

void setAddress2( const char *strAddress2 ) 
sAddressLi ne2 = strAddress2; ); 

void setCity(const char *strCity) 
sCi ty = strCi ty ; } ; 

void setState(const char *strState) 
sState = strState ; } ; 

void setZipCode( const char *strZipCode ) 
sZipCode = strZipCode; ); 



Notice that in Listing 2-1, our base class (the 
?? class) contains all the data we'll be using in 
common for the two derived classes (the File 
Mai 1 i ngLi stEntry and Command Li neMai 1 i ng 
Li stEntry classes), and implements two 
methods — Fi rst and Next, which allow those 
derived classes to override the processes of 
loading the components of the data (whether 
from a file or the command line). 

Listing 2-2: The FileMailingListEntry Class 

class FileMailingListEntry : public BaseMai 1 i ngLi stEntry 
{ 

FILE *fpln; 
publ i c : 

Fi 1 eMai 1 i ngLi stEntry ( const char *strFileName ) 
{ 

fpln = f open ( strFi 1 eName , "r"); 

} 

virtual bool ReadEntry(void) 
{ 



3. Save the file in your source-code editor. 

4. Using your favorite code editor, add the code in 
Listing 2-2. 

You may optionally save this code in a separate 
header file and include that header file in your 
main program as well. 
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char szBuffer[ 256 ] ; 

fread( szBuffer, si zeof ( cha r ) , 255, fpln ); 
if ( feof(fpln) ) 

DropBQiH 

setFi rstN 
fread( sz 
setAddres 
fread( sz 
setAddres 
fread( sz 
setCi ty ( 
fread( sz 
setState( 
fread( sz 
setZipCode( szBuffer ); 
return true; 

virtual bool First(void) 

// Move to the beginning of the file, read in the pieces 
fseek( fpln, OL, SEEK_SET ); 
return ReadEntry ( ) ; 

virtual bool Next(void) 

// Just get the next one in the file 
return ReadEntry ( ) ; 



aW( szBuffer ) ; 
BTfffer, sizeof(char) 
ame( szBuffer ) ; 
Buffer, sizeof(char) 
si ( szBuffer ) ; 
Buffer, sizeof(char) 
s2( szBuffer ); 
Buffer, sizeof(char) 
szBuffer ) ; 
Buffer, sizeof(char) 

szBuffer ) ; 
Buffer, sizeof(char) 



255, fpln ); 

255, fpln ); 

fpln ); 

fpln ); 

255, fpln ); 

255, fpln ); 



255 
255 




Please note that we do no error-checking in any 
of this code (that's to avoid making it any larger). 
A closer look at this object (before moving on to 
the last object in the group) shows that this class 
allocates no storage for the various components 
of the mailing-list entry — nor will you find any 
accessor functions to retrieve those compo- 
nents. Yet the class is derived from the base 
class (which implements all this functionality), 
so we can utilize the storage defined there. This 
is a really nice feature; it allows us to encapsu- 
late the data in one place and put the "real" func- 
tionality in another. You can also see that we've 



implemented the two required pure virtual func- 
tions (Fi rst and Next) to make the class read 
the data from a file. 

5, Save the source file in your source-code 
re-editor. 

6. Using the code editor, add the code in Listing 
2-3 to your source-code file. 

You may optionally save this code in a separate 
header file and include that header file in your 
main program as well. 

7[ Save the source file in your source-code editor. 
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Listing 2-3: The CommandLineMailingListEntry Class 

class CommandLineMailingListEntry : public BaseMai 1 i ngLi stEntry 



nst char *prompt, char *szBuffer ) 

puts (prompt ) ; 
gets ( szBuf f er ) ; 

// Remove trailing carriage return 
szBuffer[strlen(szBuffer)-l] = 0; 

if ( strl en ( szBuf f er ) ) 

return true; 
return false; 

} 

bool GetAnEntry ( ) 
{ 

char szBuffer[ 80 ]; 

if ( GetALinet "Enter the last name of the person: ", 
szBuffer ) != true ) 

return false; 
setLastName( szBuffer ); 

GetALi net " Enter the first name of the person: ", 
szBuffer ) ; 

setFi rstName( szBuffer ); 

GetALi net " Enter the first address line: ", szBuffer ); 
setAddressK szBuffer) ; 

GetALi net " Enter the second address line: ", szBuffer ); 
setAddress2( szBuffer) ; 

GetALi net " Enter the city: ", szBuffer ); 
setCi ty (szBuffer ) ; 

GetALi net " Enter the state: ", szBuffer); 
setState(szBuffer) ; 

GetALi ne (" Enter the zip code: ", szBuffer ); 
setZipCodet szBuffer); 

return true; 



publ i c : 

Command Li neMai 1 i ngLi stEntry ( ) { 
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virtual bool First(void) 
{ 

pri ntft " Enter the first name for the mailing list:\n"); 
return GetAnEntry () ; 

) 

virtual bool Next(void) 
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pri ntf( " Enter the next name for the mailing list:\n"); 
return GetAnEntry ( ) ; 

DropBooks 



Testing the Mailina-List 
Application 

After you create a class, it is important to create a 
test driver that not only ensures that your code is 
correct, but also shows people how to use your 
code. The following steps show you how: 



In the code editor of your choice, reopen the 
source file to hold the code for your test 
program. 

In this example, I named the test program 

ch02 . cpp. 

2. Type the code from Listing 2-4 into your file, 
substituting your own names for the italicized 
constants, variables, and filenames. 

A more efficient approach is to copy the code 
from the source file on this book's companion 
Web site. 



Listing 2-4: The Mailing-List Test Program 



void ProcessEntries( BaseMai 1 i ngLi stEntry *pEntry ) 



bool not_done = pEntry->Fi rst( ) ; 

while ( not_done ) 

{ 

// Do something with the entry here. 

// Get the next one 
not_done = pEntry->Next( ) ; 



int main(int argc, char **argv) 
f 

i nt choi ce = 0 ; 



pri ntf( " Enter 1 to use a file-based mailing list\n"); 
pri ntf( " Enter 2 to enter data from the command line\n"); 
scant ( "%d" , &choi ce ) ; 



if ( choice == 1 ) 
{ 

char szBuffer[ 256 ] ; 

pri ntf( " Enter the file name: "); 

gets ( szBuf f er ) ; 

Fi 1 eMai 1 i ngLi stEntry fml e( szBuf f er ) ; 
ProcessEntries( &fmle ); 



(continued) 
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Listing 2-4 (continued) 



el se 

2 ) 



■— \ if ( choice = 

DropBooEs 

DrnroccFn 



neMai 1 i ngLi stEntry cmle; 
ProcessEntries( &cmle ); 
I 

el se 

pri ntf ( " Inval i d option\n"); 



return 0; 



The main function for the driver really isn't very 
busy — all it's doing is creating whichever type of 
object you want to use. The ProcessEntri es function 
is the fascinating one because it is a function that is 
working on a class type that doesn't do anything — 
it has no idea which type of mailing-list entry object 
it is processing. Rather, it works from a pointer to the 
base class. If you run this program, you will find that 
it works as advertised, as you can see in Listing 2-5. 

You could likewise create a file containing all entries 
that we just typed into the various fields above to 

Listing 2-5: The Mailing-List Program in Operation 

Enter 1 to use a file-based mailing list 
Enter 2 to enter data from the command line 

2 

Enter the first name for the mailing list: 

Enter the last name of the person: Telles 

Enter the first name of the person: Matt 

Enter the first address line: 10 Main St 

Enter the second address line: 

Enter the city: Anytown 

Enter the state: NY 

Enter the zip code: 11518 

Enter the next name for the mailing list: 

Enter the last name of the person: 



enter those fields into the system. You can do all of 
this without changing a single line of the 
ProcessEntries function! This is the power of pure 
virtual functions, and thus the power of abstraction 

When you create a set of classes that are all 
doing the same general thing, look for the 
common elements of the class and abstract 
them into a common base class. Then you can 
build on that common base in the future, 
more easily creating new versions of the 
classes as the need arises. 
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^polymorphism (from the Greek for "having many forms") is what 

happens when you assign different meanings to a symbol or opera- 
M. tor in different contexts. All well and good — but what does it 
mean to us as C++ programmers? 

Granted, the pure virtual function in C++ (discussed in Technique 2) is 
very useful, but C++ gives us an additional edge: The programmer can 
override only selected pieces of a class without forcing us to override the 
entire class. Although a pure virtual function requires the programmer to 
implement functionality, a virtual function allows you to override that 
functionality only if you wish to, which is an important distinction. 



Ay 



Allowing the programmer to customize a class by changing small 
parts of the functionality makes C++ the fastest development lan- 
guage. You should seriously consider making the individual functions 
in your classes virtual whenever possible. That way the next devel- 
oper can modify the functionality with a minimum of fuss. 



Small changes to the derived class are called virtual functions — in 
effect, they allow a derived class to override the functionality in a base 
class without making you tinker with the base class. You can use this 
capability to define a given class's default functionality, while still letting 
end users of the class fine-tune that functionality for their own purposes. 
This approach might be used for error handling, or to change the way a 
given class handles printing, or just about anything else. In the next sec- 
tion, I show you how you can customize a class, using virtual functions to 
change the behavior of a base-class method at run-time. 
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n IJraer to understand^ now base classes can be cus- 
tomized using the polymorphic ability offered by vir- 
tual functions, let's look at a simple example of 
customizing a base class in C++. 

In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch03 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 3-1 into your file, 
substituting your own names for the italicized 
constants, variables, and filenames. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 3-1: The Virtual Function Base-Class Source Code 

#i include <string> 
#i include <stdio.h> 



class Fruit 
I 

publ i c : 

Fruit ( ) 



class Orange : public Fruit 
I 

publ i c : 

Orange( ) 



virtual std::string ColorO 

{ 

return "Orange" ; 

I 

} ; 

class Apple : public Fruit 
1 

publ i c : 

Appl e( ) 

{ 

( 

virtual std::string ColorO 
1 

return " Reddi sh" ; 

} 

I ; 

class Grape : public Fruit 

{ 

publ i c : 

Grape( ) 

{ 

} 

virtual std::string ColorO 
1 

return "Red"; 



vi rtual -Frui t( ) 

{ 

pri ntf ( " Del eti ng a fruit\n"); 

} 

virtual std::string ColorO 

{ 

return "Unknown"; 



void P r i n t O 

{ 

printfC'My color is: %s\n", 
Col orO . c_str( ) ) ; 



class GreenGrape : public Grape 
1 

publ i c : 

GreenGrape( ) 

{ 
} 

virtual std::string ColorO 

{ 

return "Green"; 
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Testing the Virtual 

w you shouldtest the code. The following steps 
show you how: 



f m Open the ch03 . cpp source file in your favorite 
source-code editor and add the code in Listing 
3-2 to the bottom of the file. 



Listing 3-2: The Main 


Driver for the Virtual Function 


Code 




int maintint ar 


gc, char **argv) 


X 

// Create some fruits 


Apple a; 




Grape g; 




GreenGrape g 


g; 


Orange o; 




// Show the 


col ors . 


a . Printt ) ; 




g.PrintO 




gg . Pri nt ( ) ; 




o . Pri nt ( ) ; 




// Now do it 


i ndi recti y 


Fruit *f = N 


ULL; 


f = new Appl 


e(); 


f->Print( ) ; 




delete f; 




f = new Gree 


nGrapet ) ; 


f->Print( ) ; 




delete f; 





2. Save the source code in your source-code 
editor. 

There are a few interesting things to note in this 
example. For one thing, you can see how the base 
class calls the overridden methods without hav- 
ing to "know" about them (see the lines marked 
->1 and ->2). What does this magic is a lookup 
table for virtual functions (often called the v- 
table) that contains pointers to all the methods 
within the class. This table is not visible in your 
code, it is automatically generated by the C++ 



compiler while generating the machine code for 
your application. When the linker finds a call to a 
method that is declared as vi rtual , it uses the 
lookup table to resolve that method at run-time, 
rather than at compile-time. For non-virtual 
methods, of course, the code is much simpler 
and can be determined at compile-time instead. 
This means that virtual functions do have some 
overhead (in terms of memory requirements and 
code speed) — so if you aren't going to use them 
in your code, don't declare things as vi rtual . It 
might seem counter-intuitive to define virtual 
functions in your code if you are not going to use 
them, but this is not really the case. In many 
cases, you can see future uses for the base class 
that will require that you allow the future devel- 
oper to override functionality to add new capa- 
bilities to the derived class. 

3, Save the source code as a file in the code edi- 
tor, and then close the editor application. 

4, Compile the source code with your favorite 
compiler on your favorite operating system. 

5, Run the program on your favorite operating- 
system console. 

If you have done everything properly, you should 
see the output shown below on the console window: 

The color of the fruit is: Apple 
The color of the fruit is: Red 
The color of the fruit is: Green 
The color of the fruit is: Orange 
The color of the fruit is: Apple 
Deleting a fruit 

The color of the fruit is: Green 

Deleting a fruit 

Deleting a fruit 

Deleting a fruit 

Deleting a fruit 

Deleting a fruit 

As you can see, the direct calls to the code work fine. 
In addition, you can see that the code that uses a 
base-class pointer to access the functionality in the 
derived classes does call the proper overridden vir- 
tual methods. This leaves us with only one question 
remaining, which is how the derived class destructors 
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are invoked and in what order. Let's take a look at 
that last virtual method, left undiscussed to this 
point— jtlj£ virtual destructor in the base Fruit class. 

DropBooks 

Why bo the Destructors Work} 

The interesting thing here is that the destructor for 
the base class is always called. Because the destruc- 
tor is declared as vi rtual , the destructor chains 
upward through the destructors for the other classes 
that are derived from the base class. If we created 
destructors for each derived class, and printed out 
the results, then if you created a new PurpleGrape 
GreenGrape class, for example, that was derived from 
Grape, you would see output that looked like this: 

PurpleGrape destructing 
Grape destructing 
Deleting a fruit 

This output would be shown from the line in which 
we deleted the Purpl eGrapeGreenGrape object. This 
chaining effect allows us to allocate data at each stage 
of the inheritance tree — while still ensuring that the 
data is cleaned up appropriately for each level of 
destructor. It also suggests the following maxim for 
writing code for classes from which other classes 
can be derived: 




If you ever expect anyone to derive a class 
from one you implement, make the destructor 
for the class vi rtual, and all manipulation 
methods vi rtual as well. 



Notice also that the virtual table for a base class can 
be affected by every class derived from it (as we can 
see by the GreenGrape class). When I invoke the 
Print method on a Fruit object that was created as 
a Grape-derived GreenGrape class, the method is 
invoked at the Grape class level. This means you can 
have as many levels of inheritance as you like. As 
you can see, the virtual-method functionality in C++ 
is extremely powerful. 

To recap, here is the hierarchy for calling the correct 
Pri nt method when a GreenGrape object is passed to 
a function that accepts a Fruit object: 

f m F r u i t : : P r i n t is invoked. 

2, The compiler looks at the virtual function table 
(v-table) and finds the entry for the Print method. 

3, The method is resolved to be the GreenGrape: : 
Print method. 

4, The GreenGrape : : Pri nt method is called. 
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In general, the single greatest bit of functionality that C++ has to offer is 
inheritance — the transfer of characteristics from a base class to its 
derived classes. Inheritance is the ability to derive a new class from 
one or more existing base classes. In addition to saving some coding 
labor, the inheritance feature in C++ has many great uses; you can 
extend, customize, or even limit existing functionality. This Technique 
looks at inheritance and shows you how to use multiple inheritance — a 
handy (but little-known) capability that combines the best of several 
classes into a single class for the end user. 

To really understand what's going on here, you have to understand some- 
thing about the way that C++ compilers implement inheritance — and 
how the language takes advantage of this approach. 

Each C++ class contains three sections, each with its own purpose: 



v 0 Storage for the data that belongs to the class: Every class needs data 
to work with, and this section of the class keeps the data handy. 

Jump tables: These store the static methods of the class so the com- 
piler can generate efficient instructions for calling the internal meth- 
ods of the class. 

One optional v-table for virtual methods: If a class provides no inheri- 
tance, there can be an optional v-table, which contains the addresses 
of any virtual methods in the class. There will never be more than a 
single virtual table per class, because that table contains the pointers 
to all of the virtual methods in the class. 



If a virtual method is overridden in a derived class, there's still 
( i£0 ) on 'y one v '^ a ^ e — an d it shows the address of the method that 
VJJ/ belongs to the derived class rather than to the base class. The 

static method areas repeat for each class. 



Okay, but why does inheritance work? Because the compiler generates a 
"stack" of data, followed by a "stack" of methods, it is no problem at all to 
implement any number of levels of inheritance. The levels of inheritance 
define the order of the "stacks." If a class is derived from classes A, B, 
and C, you will see the stack of methods for A, followed by the ones for B, 
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followed by the ones for C. This way, the compiler 
can easily convert the derived class into any of its 
base classes just by.selecting a point in the stack to 
lfrV|?rI*iJHf , l^^ause you can inherit data 
ilktnaWrrl m%«selves inheriting from 
otfier classes, the whole process just creates a strata 
of data and methods. This is a good thing, because it 
means that the class structure easily lends itself to 
conversions from base class to the derived class. 



The capability to extract pieces of functionality 
and save them into individual classes makes 
C++ an amazingly powerful language. If you 
identify all the individual pieces of functionality 
in your code and put them in their own base 
classes, you can quickly and easily build on 
that functionality to extend your application. 



Implementing a 

Con figuration File Class 

For the purposes of this example, assume that you 
want to implement a configuration file class. This 
class will allow you to store configuration informa- 
tion for your application in an external file and access 
it in a consistent manner throughout your program 
source code. I'm just going to explore the idea of 
creating a single functional class out of "mix-in" 
classes that do one thing very well and then move 
on. (As M*A *S*H would say, "Thank you, Doctor 
Winchester.") 

When you think about it, configuration files have two 
basic sets of functionality — a set of properties (rep- 
resenting name and value pairs) and a file manager 
(which reads and writes those pairs to and from 
disk). For it all to work right, you must implement 
the functionality for your class in exactly that way: 
first the properties, then their management. You 
should have one base class that implements the 
property management, and another one that works 
with the disk file itself. 

So, here's how to implement the class: 



f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch04 . cpp, 
although you can use whatever name you 
choose. 

2. Type the code from Listing 4-1 into your file, 
substituting your own names for the italicized 
constants, variables, and filenames. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 4-1: The Properties Source Code. 


//include <string> 
^include <stdio.h> 
^include <vector> 




class Properties 
I 




pri vate : 

struct _Prop 
{ 




publ i c : 

std : : stri ng narr 

std : : stri ng val 
publ i c : 

_Prop operator- 

aCopy ) 

( 


le ; 
ue ; 

(const _Prop& 


name = aCopy.name; 
val ue = aCopy . val ue ; 
return *this; 

} 


I ; 





std::vector< _Prop > sProps; 
publ i c : 

Properties(void) 



virtual -Properti es ( ) 



Properties( const PropertiesS aCopy ) 

{ 

std::vector< _Prop > : : const_i terator 
iter; 
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for ( iter = aCopy . sProps . begi n () ; 
iter != aCopy . sProps . end () ; ++iter ) 
sProps . i nsert( sProps . end( ) , 



int NumProperti es ( void ) 

{ 

return ( i nt ) sProps . si ze( ) ; 

} 

bool GetProperty( int idx, std::strinc 
name, std::string& value ) 

{ 

if ( idx < 0 | | idx >= 
NumProperti es ( ) ) 
return false; 
name = sProps[idx] .name; 
value = sProps [i dx] . val ue ; 
return true; 

) 

void AddProperty( const std::string& 
name, const std::string& value ) 

{ 

_Prop p; 

p. name = name; 

p . val ue = value; 

sProps . i nsert ( sProps . end () , p ); 



destroyed just yet. There's no real way of know- 
ing down the line whether this will always be 
true, so you may as well assume that the 
destructor will need to do its cleanup work at 
some point. You are building this class intention- 
ally as a base class for inheritance, however, so it 
only makes sense to make the destructor virtual. 
If your destructor is virtual, all derived classes 
will call the base class destructor as the last part 
of the destruction process, insuring that all allo- 
cated memory is freed. 

The next step is to implement the class that man- 
ages the file part of the system. For purposes of 
space, only the write segment of the class is 
shown in Listing 4-2. However, it would be fairly 
trivial to implement a ReadAPai r method that 
would retrieve data from a file. 

3. Using your code editor, add the code from 
Listing 4-2 to your source-code file. 

In this case, we called the file ch04 . cpp. 



Listing 4-2: The SavePairs Class 



class SavePairs 



FILE *fpln; 



Note that this class makes use of the Standard 
Template Library (STL), which I show you in 
greater detail in Part V of this book. For now, you 
can simply assume that the vector class imple- 
ments a generic array that can be expanded. The 
vector class requires no minimum number of ele- 
ments, and can be expanded as far as memory 
permits. 

Our property class will form the basis for a series 
of property types, all of which could handle dif- 
ferent types of properties. In addition, this class 
can be used as a base for other classes, which 
need the ability to store property information. 

There is really no magic here; you can see that 
the class simply holds onto property sets and 
can either add them or give them back to the 
caller. Note, however, that you have implemented 
a virtual destructor (see -> 1) for the class — 
even though nothing in the class needs to be 



ic: 

SavePairst void ) 




{ 

fpln = NULL; 

1 




SavePairst const char 
r 


*strName 


i 

fpln = fopen( strName, "w" 

i 


virtual -SavePairst) 




{ 

if ( fpln ) 





fcl ose(fpln) ; 

} 

void SaveAPair( std::string name, 

std : : stri ng value ) 

{ 

if ( fpln ) 

f pri ntf ( f pin , "%s=%s\n", 
name.c_str( ) , val ue . c_str( ) ) : 
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Once again, you implement a virtual destructor 
for your class because it's intended as a base 
;Ja£s for inheritance; no point getting specific 

»y just yet. You do, however, 
I destructor, because the 
file pointer that opens in the constructor has to 
have a corresponding closing instruction (f cl ose) 
to free the memory and flush the file to disk. 

With the virtual destructor in place, the only 
thing left to do is to combine these two fairly 
useful classes into a single class that includes 
the functionality of both and provides a cohesive 
interface to the end user of the class. We'll call 



) ) 



SaveAPairt name, value ): 



this combined 


class ConfigurationFile. 




4. Using your code editor, add the code in 
Listing 4-3 to your source-code file. 




Listing 4-3: The ConfigurationFile class 




class Configurai 
public SaveP 

{ 


:ionFile : public Properties, 
airs 


publ i c : 

Conf i gurati i 
: SavePi 

{ 


in Fi 1 e( voi d ) 
li r s ( ) 


2 


} 

Conf i gurati < 
*strFi 1 eNarm 
: SavePi 


)nFi 1 etconst char 
;) 

li rs ( st r Fi 1 eName ) 


-> 3 



virtual -Conf i gurati onFi 1 e( ) 

{ 

DoSave( ) ; 

} 

bool DoSave( ) 



std : : st ri ng name ; 
std : : stri ng val ue ; 



return true; 



for (int i=0; i <NumProperti es ( ) ; ++i ) 

{ 

if ( GetProperty( i, name, value 



S, Save the source code in the code editor. 

There really isn't a lot of code here, but there is a lot 
to pay attention to. First of all, notice the DoSave 
method. This method, which flushes all of the pairs 
of property data to disk (see -* 4), calls methods in 
both of our base classes. You will notice that you 
don't have to do anything important to get at these 
methods, they are just a built-in part of the class 
itself. 

Probably the most crucial part of Listing 4-3 is actu- 
ally a line by itself in one of the constructors. Note 
the line marked -» 3. 

This line is one of the more powerful constructs in 
C++. Because the Conf i gurati onFi 1 e class is derived 
from the SavePairs class, it will automatically call 
the constructor for the SavePairs class before it 
invokes its own constructor code. Because this is 
necessary, the base class has to be properly con- 
structed before you can work with the derived class. 
The compiler calls the default constructor unless 
you tell it to do otherwise. In this case, you do not 
want it to call the default constructor (see -> 2), 
because that would create a SavePairs object that 
had no filename (because it is not assigned in the 
constructor) and therefore did not open our prop- 
erty file. We want the entire thing to be completely 
automatic, so we invoke the proper form of the con- 
structor before our ConfigurationFile constructor 
even starts. That generates a little programming 
peace of mind: As soon as you enter the code for the 
inherited class, you can be assured that all setup 
work has been done — which (in this case) also 
means the file is open and ready to be written to. 
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Ajer you create a class, create a test driver that not 
only ensures that your code is correct, but also 
shows people how to use your code. 



$ ./a.exe 

$ cat test.dat 
Name=Matt 

Address=1000 Main St 

As you can see, the configuration file was properly 
saved to the output file. 



1 m In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 
ch04 . cpp. You could, of course, call this program 
anything you wanted, since filenames are only 
human-readable strings. The compiler does not 
care what you call your file. 

2. Type the code from Listing 4-4 into your file. 

Or better yet, copy the code from the source file 
on this book's companion Web site. 

Listing 4-4: The ConfigurationFile Test Program 

int maintint argc, char **argv) 

{ 

ConfigurationFile cfCtest.dat") ; 
cf .AddProperty ( "Name", "Matt" ); 
cf . AddProperty ( "Address", "1000 Main 
St" ); 

} 



3. Save the code in the source-code file created 
in your editor, and then close the editor 
application. 

4. Compile the source code with your favorite 
compiler on your favorite operating system. 

5. Run the program on your favorite operating- 
system console. 

If you've done everything properly, you should see 
the following output from the program on the con- 
sole window: 



Delayed Construction 

Although the constructor for a class is all wonderful 
and good, it does bring up an interesting point. What 
if something goes wrong in the construction process 
and you need to signal the user? You have two ways 
to approach this situation; both have their positives 
and negatives: 

v* You can throw an exception. In general, how- 
ever, I wouldn't. Throwing exceptions is an 
option I discuss later, in Technique 53 — but 
doing so is rarely a good idea. Your users are 
really not expecting a constructor to throw an 
exception. Worse, an exception might leave the 
object in some ambiguous state, where it's 
unclear whether the constructor has finished 
running. If you do choose this route, you should 
also make sure that all values are initialized 
before you do anything that might generate an 
exception. (For example, what happens if you 
throw an exception in a base-class constructor? 
The error would be propagated up to the main 
program. This would be very confusing to the 
user, who wouldn't even know where the error 
was coming from.) 

You can delay any work that might create an 
error until later in the processing of the object. 

This option is usually more valuable and is worth 
further exploration. 

Let's say, for example, that you are going to open a 
file in your constructor. The file-opening process 
could certainly fail, for any number of reasons. One 
way to handle this error is to check for it, but this 
might be confusing to the end user, because they 
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would not understand where the file was being 
opened in the first place and why it failed to open 
properdin cases like this, instead of a constructor 




-i 1 eOpener : : Fi 1 eOpener( const char 
"strFil eName ) 

fpln = f open ( strFi 1 eName , "r"); 



. . . you might instead choose to do the following: 

Fi 1 eOpener : : Fi 1 eOpener( const char 
*strFi 1 eName ) 

{ 

// Hold onto the file name for later 
use . 

sFileName = strFileName; 
blsOpen = false; 

1 

bool Fi 1 eOpener :: OpenFi 1 e( ) -> 5 

{ 

if ( iblsOpen ) 
{ 

fpln = fopen(sFileName.c_str( ) , 
"r") ; 

if ( fpln != NULL ) 
blsOpen = true; 

} 

return blsOpen; 

} 

Because we cannot return an error from a constructor 
directly, we break the process into two pieces. The 
first piece assigns the member variables to the values 
that the user passed in. There is no way that an error 
can occur in this process, so the object will be prop- 
erly constructed. In the Open Fi 1 e method (-» 5 in the 
above listing), we then try to open the file, and indi- 
cate the status as the return value of the method. 

Then, when you tell your code to actually read from 
the file, you would do something like this: 

bool Fi 1 eOpener :: SomeMethod ( ) 

{ 

if ( OpenFi let) ) 

{ 

// Continue with processing 



I 

el se 

// Generate an error 
return false; 

) 

The advantage to this approach is that you can wait 
until you absolutely have to before you actually open 
the file that the class operates on. Doing so means you 
don't have file overhead every time you construct an 
object — and you don't have to worry about closing 
the darn thing if it was never opened. The advantage 
of delaying the construction is that you can wait 
until the data is actually needed before doing the 
time and memory expensive operation of file input 
and output. 

With a little closer look back at the SavePairs class 
(Listing 4-2), you can see a very serious error lurking 
there. (Just for practice, take a moment to go back 
over the class and look for what's missing.) 

Do you see it? Imagine that you have an object of 
type SavePairs, for an example. Now you can make a 
copy of that object by assigning it to another object 
of the SavePai rs class, or by passing it by value into 
a method like this: 

DoSave( SavePairs obj ); 

When you make the above function call, you are 
making a copy of the obj object by invoking the copy 
constructor for the class. Now, because you didn't 
create a copy constructor, you have a serious problem. 
Why? A copy is a bitwise copy of all elements in the 
class. When a copy is made of the FILE pointer in the 
class, it means you now have two pointers pointing to 
the same block of memory. Uh-oh. Because you will 
destroy that memory in the destructor for the class 
(by calling fcl ose), the code frees up the same block 
of memory twice. This is a classic problem that you 
need to solve whenever you are allocating memory 
in a class. In this case, you really want to be able to 
copy the pointer without closing it in the copy. So, 
what you really need to do is keep track of whether 
the pointer in question is a copy or an original. To 
do so, you could rewrite the class as in Listing 4-5: 
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Listing 4-5: The Revised SavePairs Class 

class SavePairs 
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publ i c : 

SavePairs( void ) 

{ 

fpln = NULL; 
blsACopy = false; 

} 

SavePairst const char *strName ) 

{ 

fpln = fopent strName, "w" ); 
blsACopy = false; 

} 

SavePairst const SavePairs& aCopy ) 

{ 

fpln = aCopy.fpIn; 
blsACopy = true; 

} 

virtual -SavePairst) 

{ 

if ( fpln && IblsACopy ) 
fcl ose(fpln) ; 

} 

void SaveAPairt std::string name, 
std : : stri ng value ) 

{ 

if ( fpln ) 

f pri ntf ( f pin , "%s=%s\n", 
name.c_str( ) , val ue . c_str( ) ) ; 



3. Delete the original SavePairs object. 

4. Invoke a method on the copy that uses the file 
pointer. 

What happens in this scenario? Nothing good, you 
can be sure. The problem occurs when the last step 
is hit, and the copied file pointer is used. The origi- 
nal pointer has been deleted, so the copy is pointing 
at junk. Bad things happen — and your program 
likely crashes. 

A joke that runs around the Internet compares vari- 
ous programming languages in terms of shooting 
yourself in the foot. The entire joke is easy enough 
to find, but the part that applies to this subject looks 
something like this: 

C: You shoot yourself in the foot. 

C++: You accidentally create a dozen instances of 
yourself and shoot them all in the foot. Providing 
emergency assistance is impossible because you 
can't tell which instances are bitwise copies and 
which are just pointing at others, saying, "That's me 
over there." 

Many programmers find the joke is too true to be 
amusing. C++ gives you the (metaphorical) ability to 
blow off your foot any time you try to compile. 
There are so many things to think about, and so 
many possibilities to consider. 



This code in Listing 4-5 has the advantage of working 
correctly no matter how it is handled. If you pass a 
pointer into the file, the code will make a copy of it 
and not delete it. If you use the original of the file 
pointer, it will be properly deleted, not duplicated. 

This is an improvement. But does this code really fix 
all possible problems? The answer, of course, is no. 
Imagine the following scenario: 

1 , Create aSavePairs object. 

2. Copy the object by calling the copy constructor 
with a new object. 




The best way to avoid the disasters of the past 
is to plan for them in the future. This is 
nowhere more true than when you're working 
with the basic building blocks of the system, 
constructors and destructors. If you do not do 
the proper groundwork to make sure that 
your class is as safe as possible, you will pay 
for it in the long run — each and every time. 
Make sure that you always implement virtual 
destructors and check for all copies of your 
objects in your code. Doing so will make your 
code cleaner (dare I say "bulletproof"?) and 
eliminate problems of this sort that would oth- 
erwise naturally crop up later. 
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One of the biggest problems in the software-development world is 
maintaining code that we did not design or implement in the first 
place. Often the hardest thing to do in such cases is to figure out 
exactly how the code was meant to work. Usually, there is copious docu- 
mentation that tells you what the code is doing (or what the original pro- 
grammer thought was going on), but very rarely does it tell you why. 

The reason is that the business rules and the data that implement those 
rules are usually embedded somewhere in the code. Hard-coded dates, 
values — even user names and passwords — can be hidden deep inside 
the code base. Wouldn't it be nice if there was some way to extract all of 
that data and those business rules and put them in one place? This really 
does sound like a case for encapsulation, now doesn't it? Of course it 
does. As I discuss in Technique 1, encapsulation allows us to insulate the 
user from the implementation of things. That statement is ambiguous 
and means quite a few things, so to clarify, let me show you a couple of 
examples. First, consider the case of the business rule. 

When you are creating code for a software project, you must often con- 
sider rules that apply across the entire business — such as the allowable 
number of departments in an accounting database, or perhaps a calcula- 
tion to determine the maximum amount of a pay raise for a given 
employee. These rules appear in the form of code snippets scattered 
across the entire project, residing in different files and forms. When the 
next project comes along, they are often duplicated, modified, or aban- 
doned. The problem with this approach is that it becomes harder and 
harder to keep track of what the rules are and what they mean. 

Assume, for the moment, that you have to implement some code that 
checks for dates in the system. (Okay, a date isn't strictly a business rule 
per se, but it makes a handy example.) To run the check, you could try 
scattering some code around the entire system to check for leap years, 
date validity, and so forth, but that would be inefficient and wasteful. 
Here's why that solution is no solution at all: 
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Once upon a time, there was a project being done at 
a very large company. A software audit showed at 
least fuie^iifferent routines (functions, macros, and 
|eJTTfcan|c|tfP^d whether a given year 
' yelrVrfiisVfc^pretty surprising — but 
even more surprising was that of those five routines, 
three were actually wrong. If a bug occurred while 
the system was calculating whether the current year 
was a leap year, did the programmer have any idea 
where to look to solve the problem? Of course not. 

In this example, despite the risk of bugs, you still 
have to determine whether a given date is valid — 
and whether the given year is a leap year. Your first 
two basic tasks are to set appropriate defaults for 
the date, and make sure you can retrieve all the com- 
ponents of the date. The same approach works for 
any business-rule encapsulation. First, you have to 
know the pieces of the puzzle that go into the calcu- 
lations. That way, anyone looking at the code will 
know exactly what he or she needs to supply. There 
should be no "hidden" data unless it's being 
retrieved from an external source. The code should 
be plug-and-play; you should be able to take it from 
one project to another with minimal changes. 

Of course, it's often impossible to completely 
remove application code from business rules. But 
that really shouldn't be your goal when you're writ- 
ing business objects. Instead, you should worry 
about how those objects are going to be used. 

When you separate the support code from the 



I 



business rule that it supports, you separate the 
bugs that can occur into two types: physical 
errors and logical errors. This alone saves time 
in tracking down problems. A logical error 
won't crash a program, but it will cause grief in 
other ways. A physical error isn't likely to 
cause you to incorrectly generate checks for 
billions, but it will crash your application and 
annoy your users. 



Your object should be portable; it is going to be used 
in multiple projects to support the "date rule." You 
want your dates to be valid, and you want to be able 
to extract the components of the date in any project 




that might need that data. At the same time, you 
don't want to give people more than they need, so 
you aren't going to bother supporting date math, 
such as calculations for adding days or years to a 
given date. 



This is another important tip when designing 
classes for use in C++, whether they are busi- 
ness objects or full-blown application objects. 
Always keep the code down to a minimum; 
only include what people need. Do not simply 
add methods to a class for the sheer joy of 
adding them. If you bury people in code, they 
will look for something simpler. There is a 
common acronym for this in the engineering 
community, known as "KISS": Keep It Simple, 
Stupid. 

Always bear the error-handling process in 
mind when you write reusable objects. Your 
code is more reusable if it returns error mes- 
sages instead of throwing exceptions or log- 
ging errors to some external source. The 
reason for this advantage is simple: If you 
require people to do more than check the 
return value of a method or function in your 
code, you force them to do a lot of work that 
they might not otherwise have to do. People 
resist doing extra work; they'll avoid your code 
and use something simpler. (Once again, the 
KISS principle in action.) 
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In order to best encapsulate all of the date informa- 
tion in your program, it is easiest to create a single 
class that manages date storage, manipulation, and 
output. In this section, we create a class to do all of 
that, and call it cDate (for date class, of course). With 
a date class, we are removing all of the rules and 
algorithms for manipulating dates, such as leap year 
calculations, date math, and day of week calcula- 
tions, and moving them into a single place. In addi- 
tion, we move the date storage, such as how the day, 
month, and year elements are stored, into one area 
that the user does not need to be concerned about. 
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f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
source fil 




fl|^iy Vffihiaiy\l3yie is named ch05 . cpp, 
although you can use whatever you choose. 



2. Type the code from Listing 5-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 5-1: The cDate Class 

#include <string> 
#include <stdio.h> 
^include <time.h> 



class cDate 

{ 

pri vate : 

int MonthNo; 

int DayOfMonth; 

int DayOfWeek; 

long YearNo; 
protected : 

void GetTodaysDatet ) 

{ 

// First, get the data 
time_t t; 
time(&t) ; 

struct tm *tmPtr = local time(&t) ; 

// Now, store the pieces we care about 
MonthNo = tmPtr->tm_mon ; 
YearNo = tmPtr->tm_yea r + 1900; 
DayOfMonth = tmPtr->tm_mday ; 
DayOfWeek = tmPtr->tm_wday ; 

> 



int ComputeDayOfTheweekt ) // returns day of week 

< 

int sum_calc; 

int cent_off, year_off, month_off, day_off; 
int year_end; 

year_end = YearNo % 100; // year in century 

// The following calculation calculates offsets for the 
// century, year, month, and day to find the name of the 
// weekday. 

cent_off = ((39 - (YearNo/100) ) % 4 ) * 2; 

year_off = year_end + year_end/4; 
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if (MonthNo 



1) 



// January 



monin 

DropBotfK 



month_off = 0; 

arNo%4) == 0) && ((year_end !=0) 
MOO) == 0))) 
_of f - - ; //I eap year 



else if (MonthNo 



2) 



// February 



month_off = 3; 

if (((YearNo%4) == 0) && ((year_end !=0) 
( (YearNo%400) == 0))) 
year_off-- ; 



1 

el se if ( (MonthNo == 3) 

month_off = 3; 
el se if ( (MonthNo == 4) 

month_off = 6; 
else if (MonthNo == 5) 

month_off = 1; 
else if (MonthNo == 6) 

month_off = 4; 
else if (MonthNo == 8) 

month_off = 2; 
el se if ( (MonthNo == 9) 

month_off = 5; 
else if (MonthNo == 10) 

month_off = 0; 



/ / 1 eap year 
| (MonthNo == ID) 
I (MonthNo == 7)) 



// 


May 


// 


June 


// 


August 



(MonthNo 



12)) 



// October 



day_off = DayOfMonth % 7; // day offset 

sum_calc = (cent_off + year_off + month_off + day_off) 1 7; 

// Using the calculated number, the remainder gives the day 
// of the week 
sum_cal c %= 1 ; 

return sum_calc; 

} 

int MonthDays( int month, long year ) 
1 

i f ( month < 0 | | month > 11 ) 
return 0; 

int days[]={31,28,31,30,31,30,31,31,30,31,30,31 }; 
int nDays = days[ month ]; 



(continued) 
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Listing 5-1 (continued) 

if ( IsLeapYear( year ) && month == 1) 

DropBaoRs 

publ i c : 

cDate(void) 

{ 

// Get today's date 
GetTodaysDate( ) ; 

I 

cDate( int day, int month, long year ) 

{ 

if ( IsValidDate( day, month, year ) ) 

{ 

MonthNo = month; 
DayOfMonth = day; 
YearNo = year; 

DayOfWeek = ComputeDayOfTheWeek( ) ; 




cDate( const cDate& aCopy ) 

{ Bk 

YearNo = aCopy . Yea rNo ; 
MonthNo = aCopy . MonthNo ; 
DayOfMonth = aCopy . DayOfMonth ; 
DayOfWeek = aCopy . DayOfWeek ; 

} 

// Accessors 

int Month () ) return MonthNo; ); 
long YearO { return YearNo; ); 
int Day() ) return DayOfMonth; 1; 
int DayOff heWeek( ) { return DayOfWeek; ); 
bool I sVal i dDate( i nt day, int month, long year); 
bool IsLeapYear( long year ); 




3. In your code editor, add the code in Listing 5-2 
to the source-code file for your application. 
Alternatively, you could create a new file 
called date.cppto store all of this information 
separately. 



These are the non-inline methods for the class. 
You can put them in the same file as your origi- 
nal source code, or create a new source file and 
add them to it. 
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Listing 5-2: Non-Inline Methods 



bool cDate: : IsVal idDatet int day, int month, long year ) 



DropBcmks 

ro+nrn f al 



valid? 

month > 11 ) 

return false; 
// Is the year val id? 
if ( year < 0 | | year > 9999 ) 
return false; 

// Is the number of days valid for this month/year? 
if ( day < 0 || day > MonthDays (month , year) ) 
return false; 

// Must be ok 
return true; 

} 

bool cDate: : IsLeapYeart long year ) 

{ 

int year_end = year % 100; // year in century 

if (((yearM) == 0) && ((year_end !=0) || ((yearMOO) == 0))) 

return true; 
return false; 



Putting this code into a single object and sharing 
that code among various projects that might need 
this functionality offers some obvious advantages: 

If the code needs to be changed, for example, to 
account for some bug in the leap year calcula- 
tion, this change can all be done in one place. 

j>* More importantly, if changes are made to imple- 
ment a newer, faster way to calculate the leap 
year or the day of the week, or even to add func- 
tionality, none of those changes affect the calling 
programs in the least. They will still work with 
the interface as it stands now. 



Testing the cbate Class 

After you create a class, it is important to create a 
test driver — doing so not only ensures that your 
code is correct, but also shows people how to use 
your code. 

In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

chl_5 . cpp. 

2. Type the code from Listing 5-3 into your file. 



Better yet, copy the code from the source file on 
this book's companion Web site. 
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Listing 5-3: The cDate Class Test Program 



^include <iostream> 
usif«^namespac» std; 



usi|w^namespac» std ; 

DropBaoEs 



ar **argv) 



// Do some testing. First, a valid date 
cDate dl ( 31 , 11 , 2004) ; 
// Now, an invalid one. 
cDate d2 ( 31 , 12, 2004); 

// Finally, let's just create a blank one. 
cDate d3; 

// Print them out 



cout << 


"Dl 


: " << 


"Month : 


" << 


dl 


,Month( ) 


<< 


" Day: 


" << 


dl 


.DayO 


<< 


" Year: 


" << 


dl. 


.YearO 


<< endl ; 




































cout << 


"D2 


: " << 


"Month : 


" << 


d2 


.MonthC ) 


<< 


" Day: 


" << 


d2 


.DayO 


<< 


" Yea 


r : 


" << 


d2. 


.Year() 


<< endl ; 




































cout << 


"D3 


: " << 


"Month : 


" << 


d3 


.MonthC ) 


<< 


" Day: 


" << 


d3 


.DayO 


<< 


" Yea 


r : 


" << 


d3. 


.YearO 



<< endl ; 
return 0; 



3. Save the source code as a file in your code edi- 
tor and close the editor application. 

4. Compile the source code with your favorite 
compiler on your favorite operating system. 

5. Run the program on your favorite operating 
system console. 

If you have done everything properly, you should 
see the following output from the program on the 
console window: 

$ ./a.exe 

Dl: Month: 11 Day: 31 Year: 2004 
D2: Month: 2011708128 Day: -1 Year: 

2011671585 
D3: Month: 8 Day: 7 Year: 2004 



Note that the numbers shown in the output 
may be different on your computer, because 
they are somewhat random. You should sim- 
ply expect to see very invalid values. 

This, then, is the advantage to working with object- 
oriented programming in C++: You can make changes 
"behind the scenes" without interfering with the 
work of others. You make it possible for people to 
get access to data and algorithms without having to 
struggle with how they're stored or implemented. 
Finally, you can fix or extend the implementations 
of your algorithms without requiring your users 
to change all their applications that use those 
algorithms. 
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The problem with the "standard" C++ header files is that they are 
anything but standard. For example, on Microsoft Windows, the 
header file for containing all of the "standard" output functions is 
stdi o . h — whereas on Unix, the header file is uni std . h. Imagine you're 
compiling a program that can be used on either Unix or Microsoft 
Windows. The code in all your files might look like this: 

fifdef WIN32 
//include <stdio.h> 
#el se 

#ifdef UNIX 
#indude <unistd.h> 
#endi f 
#endi f 

This approach to coding is messy and inefficient: If you get a new com- 
piler that implements the constants for the operating system differently, 
you will have to go through each and every file to update your code. 
As an alternative, you could simply include all the files in a single header 
file — but that would force you to include a lot of header files that you 
really don't need in many of your program files, which would increase the 
file bloat and could conceivably cause problems if you need to override 
some of the standard function names or types. Obviously, clutter is not a 
very good solution either way. 

What if — instead of including the things you don't want and having to 
compile conditionally around them — you could include only the "right" 
files for a specific operating system in the first place? That solution 
would certainly be closer to ideal. Fortunately, the C++ pre-processor 
offers a perfect way to solve this problem. Read on. 



Creating the Header File 

In order to be able to conditionally include the pieces of the code we 
wish to use in our application, we will create a single header file that uti- 
lizes pre-compiler defined values to determine the files that are needed. 
The following steps show you how to create such a file: 
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1, In the code editor of your choice, create a new 
file to hold the code for the source file of the 
inique. 



i— v toahnique. , 
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|I|^JleJefciiMC\hQjle is named, osdefines.h 

although you can use whatever you choose. This 
file will contain the header information. 

2, Type the code from Listing 6-1 into your file, 
substituting your own names for the italicized 
constants, variables, and filenames. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 6-1: The Headef 


i File. 


#ifndef _osdefii 
#define _osdefii 


ies_h_ 
ies_h_ 


// Remove the c< 
if you are 

// developing oi 
form. Remove 

// the comment ( 
devel opi ng 

// on the UNIX | 


)mment from the WIN32 define 
i the Microsoft Windows plat- 
an the UNIX define if you are 
)1 atf orm 


#define WIN32 
// #define UNIX 




// Now, define j 
Windows plat 


;he header files for the 
form 



#ifdef WIN32 
#define standa rd_i o_header <stdio.h> 
#endi f 

#ifdef UNIX 

#define standa rd_i o_header <unistd.h> 
#endi f 

// Make sure SOMETHING is defined 

#ifndef standa rd_i o_header 

#error "You must define either WIN32 or 

UNIX" 
#endi f 

#endif // _osdefines_h 



3. Save the source code as a file in the code editor 
and close the code-editor application. 



Testing the Header Fife 

After you create the class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 

Here I show you how to create a test driver that illus- 
trates various kinds of input from the user, and 
shows how the class is intended to be used. 



Always make sure that you test your code in 
the scenario most likely for your end user. 

In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 
ch06 . cpp. 

2, Type the code from Listing 6-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 




Listing 2-2: The Main Program 

#include "osdefines.h" 
#include standard_i o_header 

#define MAX_VALUES 100 
#define STRING(A) #A 
#define PASTE(A.B) (A##B) 

#define MAKE_SAFE(s) (s==NULL? "NULL" : s ) 

int maind'nt argc, char **argv) 

{ 

int x = 100; 

// We can stringify a variable name 
printf("The value of %s is %d\n", 
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STRING(x), x ); 



Drop^fe, 



macro to create a new 



variable. 



PASTE(x.y) = x*y; 

printfC'The value of x = %d\n", x ); 
printfC'The value of y = %d\n", y ); 

// The problem is that we can't 

stringify pastes. 
printfC'The value of %s = %d\n", 
STRING(PASTE(x,y)), xy ); 

char *sl = NULL; 

char *s2 = "Something"; 

printf ("Stringl = %s\n", MAKE_SAFE(sl! 
printf ("String2 = %s\n", MAKE_SAFE(s2: 

return 0; 



the WIN32 and Unix lines in the osdefines.h file. Try 
compiling it and you should see an error message 
like this one: 

$ gcc test.cpp 

In file included from test.cpp:2: 

osdef i nes . h : 23 : 2 : #error "You must define 

either WIN32 or UNIX" 
test . cpp : 3 : 10 : #include expects "FILENAME" 

or <FI LENAME> 

As you can see, the compiler definitely knows that 
the operating system is not defined. The next step is 
to define one of the two constants, depending on the 
operating system of your choice. There are two dif- 
ferent ways to define these constants. You can either 
put a #def i ne statement at the top of the header file 
or you can pass the value into the compiler with the 
-D compile flag. Recompiling the program after this 
operation should result in no errors — and if that's 
the case, you know the proper header file is now 
being included! 



3. Save the source file in your code editor and 
close the code-editor application. 

4. Compile the file with your favorite compiler on 
your favorite operating system. 

To verify that your header file will not work unless 
you define the operating system, comment out both 
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This technique is very easy to implement — 
and very powerful when you're working with 
multiple operating systems, compilers, or even 
libraries. Just keep all system-related data in 
one header file, and allow the pre-processor to 
do the rest of your work for you. It is also very 
valuable, because it allows you to give header 
files really meaningful names, rather than 
stdi o . h. What, exactly, is a stdio (an s-t-d-i- 
o?) anyway? 
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asserts can cause 

V Compiling with asserts 

V Fixing assert problems 



It's hard to talk about the C++ pre-processor without talking about the 
assert macro. This particular macro is used to test a given condition — 
and, if the condition is not logically true, to print out an error message 
and exit the program. 

Here's where you can get (ahem) assertive with the problem of testing 
for problems, so a quick look at asserts is in order, followed by a simple 
technique for using them. 



The Assert Problem 

The purpose of an assert statement is to check for a problem at run- 
time. Assert statements have value during the initial debugging and vali- 
dation of code, but they have limited value once the program is out in the 
field. For this reason, you should put in enough assert statements to be 
sure that the tests of your system will reveal all of the potential problems 
that you should check for and handle at run-time. Let's look at a simple 
example of using an assert call in your program. 



1, In the code editor of your choice, create a new file to hold the code 
for the source file of the technique. 

In this example, the file is named ch07 . cpp, although you can use 
whatever you choose. This file will contain the source code for our 
example. 

2. Type the code in Listing 7-1 into your file, substituting your own 
names for the italicized constants, variables, and filenames. 

Better yet, copy the code from the source file on this book's compan- 
ion Web site. 



The Assert Problem 



Listing 7-1: Using Asserts 



#include "stdio.h" 



l_ ^ #i|aJ^de "asseft.h" 
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'har **argv) 



assert( argc > 1 ) ; 
pri ntf( "Argument 1 
return 0; 



%s\n" , argv[l] ) ; 



3. Save the source-code file and close the code 
editor. 

4. Compile the source file, using your favorite 
compiler on your favorite operating system. 

If you run this program with no arguments, you 
will find that it exits abnormally and displays the 
following error message: 

$ . /a . exe 

assertion "argc > 1" failed: file 

"ch07a.cpp", line 6 
Aborted (core dumped) 

As you can see, the assert macro was triggered 
properly, and exited the program, which is the 
expected behavior of the function when it fails. 
Of course, this isn't exactly what you would nor- 
mally want the program to do when you fail to 
enter a value, but it does illustrate the source of 
the error. 
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Crashing a program intentionally, no matter 
how appealing to the programmer, is no way 
to deal with the user and will cost you time 
and effort when dealing with customer sup- 
port and technical debugging. Save yourself 
the time up front and deal with the problem 
correctly instead of aborting the application 
when an exceptional condition arises. 



Recompile the source file with your favorite 
compiler, using the N DEBUG definition on the 
command line. 

It is not simply that using an assert to exit a pro- 
gram is ugly. Well, okay, it is, but the worst part 
is that many compiler environments only define 
the assert macro when the program is compiled 
in debugging mode. In effect, the assert macro 
switches into non-operation (yep, off) when the 
program is compiled for optimized running. With 
the gcc compiler, you optimize things by compil- 
ing with the - DNDEBUG compiler switch. If you 
compile the program given here with that switch 
set, however, you get a very different set of 
output: 

$ ./a. exe 

Argument 1 = (null) 

The above is the output when you run the pro- 
gram after compiling with the - DNDEBUG flag for 
the compiler. As you can see, it is very different 
from the case where the assert macro is enabled. 

Note that there was no argument supplied to the 
program, so we are actually stepping all over 
memory at this point. Since the array of pointers 
is filled with the arguments to the application, we 
are restricted to the number of arguments passed 
in. If nothing is passed into the program, there 
will be nothing in the array of arguments, and the 
pointers in the a rgv array will be pointing at 
garbage. Fortunately, we didn't try to do anything 
with the pointer except print it out, but it could 
easily have caused a program crash of its own. 

Imagine if this code had made it into a produc- 
tion system. The first time that an optimized 
(often called a "release") build was created, the 
program would crash as soon as the user ran it 
without giving the program any arguments on 
the command line. Obviously, this is not an opti- 
mal solution when you are working in the real 
world. In the next section, I show you how to 
address this problem. 
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Fixing the Assert Problem 

Jue — especially when 
Jcularly annoying prob- 
By littering your code liberally with asserts, 
you can track down conditions you did not expect. 
However, those same asserts won't let you simply 
ignore those pesky conditions you find. To fix the 
problem, the relevant portion of Listing 7-1 should 
be rewritten. The following step shows you how. 
(Note that we are leaving in the assert for debugging 
purposes — and handling the error appropriately at 



the same time.) 




f m Modify the source code for the test application 
as in Listing 7-2. 


In this case, we 
file ch07 . cpp . 


called the original source code 


Listing 7-2: Fixing the Asserts Problem 


#include "stdio 
#i include "asser 


. h" 

t.h" 


int maind'nt an 

{ 


jc, char **argv) 


assert( argi 
if ( argc > 
pri ntf ( ' 

) ; 


: > 1 ) ; 
1 ) 

"Argument 1 = %s\n", argv[l] 


return 0; 

) 





What is the difference here? Obviously, if you compile 
the program in debug (that is, non-optimized) mode 
and run it with no arguments, the assert is triggered 
and the program exits, kicking out an error statement 
as before. If you compile in optimized mode, however, 
the assert is skipped and the program tests to see 
whether there are enough arguments to process. If 



not, the offending statement that would potentially 
crash the program is skipped. It's hard, and a little 
sad, to tell you how many programs were shipped 
into the world (over the last twenty years or so) con- 
taining functions like this: 

int func( char *s) 
{ 

assertts != NULL) ; 
strcpy ( myBuf fer , s ) ; 



This function is intended to copy an input string into 
a buffer that is supplied by the programmer. That 
buffer has a certain size, but we are not checking for 
the maximum allowable number of characters in the 
input string. If the number of characters coming in is 
bigger than the number of characters in the 
myBuf fer array, it will cause problems. 

As you can imagine, this causes a lot of problems in 
the real world, because memory that does not 
belong to the application is being used and assigned 
values. Asserts are very useful for defining test 
cases, trapping exceptional errors that you know 
could happen but shouldn't, and finding problems 
that you really didn't expect to see happen. The 
nicest thing about asserts is that after you find the 
problem that it indicates, generally you can use 
your debugger to figure out exactly what caused the 
problem — and usually the best approach is to use a 
stack-trace mechanism. In Technique 62, "Building 
Tracing into Your Applications," I show you how to 
build a mechanism like this into your application so 
that you can find problems like this at run-time. 



Always run your program through a complete 
test suite, testing for all possible asserts, in an 
optimized environment. That way, you know 
the assert calls won't hurt anything when you 
get the program into the real world. 
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Throughout this book, I often use the #def i ne statement to create 
macros and constant values for use in my programs. It's a useful 
approach — even so, there are enough downsides that the C++ 
standards group chose to create a new way to define constants in your 
application: the const statement. The const statement is used in the 
following manner: 



const i nt MaxVal ues 



100; 



If this looks familiar, it's a lot like the way I've been using the #def i ne 
statement: 

#define MAX_VALUES 100 

The difference is that the const construct is defined at the compiler level, 
rather than at the pre-processor level. With const, the compiler can better 
optimize values, and can perform type-safe checking. 

Here's an example. First, here's how the #def i ne method works. Suppose 
I write a definition like this: 

#define NoValues 0 

and then write a C++ statement that says 

char *sValues = NoValues; 

The statement will compile (although some compilers may issue a warning 
about an unsafe conversion) because the NoVal ues declaration equates to 
a string value of NULL. So far, so good — but suppose I now change that 
value by defining the following (note that any non-null value would illus- 
trate the problem the same way): 

//define NoValues -99 



The behavior of the sVal ues assignment is unpredictable. Some compilers 
will allow it, assigning a very strange character (whatever -99 is in the 
character set you are using) to the string. Other compilers will not allow 
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Technique 8: Using const Instead of ^define 



it and will complain bitterly, giving you strange errors 
to interpret and correct. Either way, the outcome is 
unpleai 



unpleasant. . 

DropBooks 



If you wrote 



const char *NoValues = -99; 

then you would immediately see how the compiler 
reacted (by generating a compile error) at the 
moment you defined the constant. The const con- 
struct is type-safe — you give it a type, and can assign 
it only to things of the same, or compatible, types; it 
won't accept anything else, so its consistency is safe 
from disruption. 

One other compelling reason to use the const con- 
struct instead of the #def i ne construct is that the 
const construct is a legitimate C++ statement that 
must compile properly on its own. The #def i ne con- 
struct is a pre-processor statement — literally 
pasted into the code by the C++ pre-processor wher- 
ever the statement is found. That arrangement can 
lead to some very strange problems. For example, 
when a string that is enclosed in quotes is pasted 
into a given position in the code, the compiler may 
interpret the quotation marks as enclosing the code 
around it as well. This may have the effect of com- 
menting out code by making it a literal string rather 
than a code string. 

Usinq the const Construct 

The C++ standard provides a method for fixing the 
problems caused by the #def i ne statement in the 
pre-processor. This statement is the const state- 
ment, which is handled by the compiler, not the pre- 
processor, and therefore makes your code easier to 
understand and debug. 

f m In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch08. cpp, 
although you can use whatever you choose. 



2. Type the code in Listing 8-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Note that in this listing, you can see the effects of 
both the #def i ne version of the statement and the 
const version of the statement. The compiler will 
interpret them differently, as we will see shortly. 



Listing 8-1: Using Constants 

#include <stdio.h> 

const int MaxValues = 100; 
#define MAXJ/ALUES 100; 



int maindnt argc, char **argv) 
( 

int myArrayE MaxValues ]; 

int my0therArray[ MAX_VALUES ]; 

for ( int i=0; i<MaxValues; ++i 

myArray [i ] = i ; 
for ( int i=0; i <MAX_VALUES ; ++i 
myOtherArray [i ] = i; 




3, Compile the application, using your favorite 
compiler on your favorite operating system. 

Compiling this ordinary-looking program, you will 
get the following error messages. (This is how it 
looks on my version of the gcc compiler; yours 
might look slightly different.) 

$ gcc ch08.cpp 

ch08.cpp: In function 'int maintint, 
char**) ' : 

ch08 . cpp : 9 : error: syntax error before ';' 
token 

ch08.cpp:13: error: syntax error before 
~ ; ' token 

ch08.cpp:14: error: 'myOtherArray' unde- 
clared (first use this function) 

ch08.cpp:14: error: (Each undeclared iden- 
tifier is reported only once for each 
function it appears in.) 



Fixing the Errors 




The next section describes how to correct these 
errors. 



rrors 



Looking at the lines that the errors appear on, it is 
quite unclear what the problem might be. The first 
line reference is marked with the -* 1 symbol. 

This certainly looks like a valid line of code — what 
could the problem be? The answer lies not with the 
compiler but with the pre-processor. Remember, the 
pre-processor takes everything that follows the 
token you define (on the #def i ne line) and faithfully 
pastes it into the code wherever it finds the token 
later on. In this case, after the paste occurs, the line 
itself is converted into 

int myOtherArray [ 100; ]; 



Fixing the Errors 



How do we fix these problems in the compiler so 
that the code does what we want? Let's take a look 
at some ways in which you can make the code com- 
pile and do what you intended, instead of letting the 
compiler guess incorrectly at what you want. 

f m Reopen the source file in your favorite code 
editor. 

2, After the file is open, modify the existing pro- 
gram to fix the compilation errors, as follows. 

Note that this code replaces the previous code 
listing, it does not get added to it. 

int maind'nt argc, char **argv) 
{ 

int xVal = 10; 

i nt myArray[ xVal ] ; 



SfT\ You can save yourself a lot of time, effort, and 
»- / -a) trouble by using the proper parts of the lan- 
\j£y guage in the proper places. The #def i ne 

mechanism is wonderful for creating macros, 
or even for defining constant strings. When it 
comes to things that are really constant values, 
use the proper syntax, which is the const 
keyword. 

Note that extra semicolon in the middle of the array 
definition. That's not legal in C++, and will cause 
errors. But rather than pointing at the "real" offending 
line, which is the #def i ne with a semi-colon at the 
end, the compiler gives you a confusing error about 
a line that looks just fine. 

The #def i ne definition may cause errors, but the 
const definition of MaxVal ues has no such problem. 
What it provides is simply a definition of a value — 
and you can then use that value anywhere in the 
program that a literal value or #def i ne constant can 
be used. 

The primary advantage of the constant is that 
it will always be evaluated properly. 



for ( int i=0; i<xVal ; ++i ) 
myArray [i ] = i ; 

return 0; 

} 




There is a danger with using this approach. 
Consider the following: 



i nt xVal ; 

i nt myArray [ xVal ] ; 




Always initialize all variables in your code, 
even if you don't think you will need them. 



In the non-optimized version of the code, xVal is 
assigned a value of 0 — which allows you to create 
an array with 0 elements in it. The trouble starts 
when you run the optimized version: The value of 
xVal is undetermined, and this code will likely cause 
a program crash. Try not to do things like this. The 
best way to fix things like this is to set the compiler 
warning level to its highest, which will detect unini- 
tialized variables that are used. 
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The pre-processor and macros are useful things, but don't go over- 
board in their use. Aside from the obvious possible disaster (the 
pre-processor goes berserk and replaces any code in your applica- 
tion with whatever resides in the macro), macros often have side effects 
that are not clear when they're invoked. Unlike functions — whose side 
effects can be detected in the debugger — a macro has no such debug- 
ging functionality. Because the pre-processor "copies" the macro's code 
into your application, the debugger really doesn't understand how the 
macro works. And even though macros allow you to avoid the overhead 
of pushing data onto the stack and popping it off to invoke a function, the 
macro increases code size by duplicating the same block of code every 
time it's used. 

Of course, these reasons by themselves aren't enough to make program- 
mers want to avoid using macros. There are much better reasons. For 
example, consider the mi n (for "minimum") macro, which many programs 
define like this: 

#define mi n C X , Y) ((X) < (Y) ? (X) : (Y)) 

Suppose you use the mi n macro with an argument that does something 
else — say, like this — 

next = min (x + y, func(z)); 

The macro expands as follows: 

next = ((x + y) < (func(z)) ? (x + y) : (func(z))); 

where x + y replaces X and func(z) replaces Y. 



In C++ programming, macros are generally a bad idea unless you are 
simply tired of typing the same code over and over. Think of them as 
a keyboard shortcut instead of as a block of code and you will save a 
lot of time debugging them. 




Initiating a Function With a String Macro — Almost 
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Now, this might not seem like a bad thing. But what 
if the f unc function has some side effect that occurs 
jre than once? The side effect 

- apparent from reading the 
lion being called twice. But 
a programmer debugging your program might be 
stunned if (for example) a function f unc cropped up 
looking like this, because it would mean that the input 
value was being changed not once, as it appears, but 
twice: 

int funcd'nt &x) 

{ 

x *= 2; 
return x; 



Obviously, this function accepts a single integer 
argument by reference. It then multiples this argu- 
ment by two and returns it. What is the problem 
here? Well, because the argument is passed by refer- 
ence, the original argument is changed. This out- 
come may be what was intended, but it can also 
cause problems, as in the case of the mi n macro. 
Instead of having the function return twice the value 
and compare it, we are actually looking at it com- 
pared to four times the argument. You can see from 
the expanded version of the macro that z will be 
passed into the function two times, and since the 
function takes its argument by reference, it will be 
modified in the main program This is very unlikely 
to be what the programmer originally intended. 

Initiating a Function u/ith a 
String Macro — Almost 

Macro issues become subtler when you're allocating 
and copying strings — which programmers do in 
C++ all the time. Here's the usual scenario: You have 
an input string, want to make a copy of it, and store 
the result in another string. A library function, called 
strdup, does this exact thing. But suppose that you 
want to copy only a certain number of bytes of 
the original string into your new string. You couldn't 



use strdup because it always duplicates the string 
entirely. Further, assume that in order to conserve 
memory, you want to remove the original string after 
copying. This might be done to shrink a string, per- 
haps, or to make sure something always fits in a par- 
ticular database field. The following steps show how 
to create code that does this handy task — imple- 
menting it as a macro and then as a function to see 
what the issues with each might be. 

In the code editor of your choice, create a new 
file to hold the code for the source file of the 



technique. 




In this example, the file is named ch09 . cpp, 
although you can use whatever you choose. 


2, Type the code in Listing 9- 


I into your file. 


Better yet, copy the code from the source file on 
this book's companion Web site. 


Listing 9-1: The Macro File 




#include <stdio.h> 
//include <string.h> 




// This will be our macro 
#define COPY_AND_TRUNC ( ns , 

if C strlen(s) > 20 ) 

( \ 

ns = new char[ 20 
memsett ns, 0, 20 
strncpyt ns, s, 20 


versi on 
s) \ 

\ 


]; \ 
); \ 
-1 ); \ 



) \ 

el se \ 
( \ 

ns = new char[ strlen(s) ]; \ 
memset( ns, 0, strlen(s) ); \ 
strcpy ( ns , s ) ; \ 

) \ 

delete s; 

int maind'nt argc, char **argv ) 

{ 

char *s = new char[80]; 

strcpy( s, "This is a really long string 

to test something" ) ; 

char *ns = NULL; 

COPY_AND_TRUNC( ns, s ); 

(continued) 
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Listing 9-1 (continued) 



Listing 9-2: The Updated Macro File 



printf("New string: [%s]\n", ns ); 

new char[80] ; 

is a really long 
Jmethi ng" ) ; 
COPY_AND_TRUNC( s2, s2 ); 
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printf("New string: 
return 0; 



[ % s ] \ n " , ns ); 



Note that you can create a multiple line macro by 
using the backslash ('\') character at the end of 
the previous line. Doing so expands the macro 
until it's almost a complete function. 

3. Compile the program with your favorite com- 
piler on your favorite operating system. 

4. Run the program on your favorite operating 
system. 

If you've done everything properly, you will see 
the following output: 

$ . /a . exe 

New string: [This is a really lo] 
New string: [(null)] 

Fwinq What Went Wrong 
With the Macro 

What happened here? The output of the last function 
call should have been the same as the first one! This 
is a serious problem that can be traced to a side effect 
of the macro. Because the procedure didn't check to 
see whether input and output were the same, you 
cannot safely delete the character-pointer buffer 
that you didn't allocate. However, by following the 
steps given here, you can rewrite this macro as an 
equivalent — but safer — function. 

f m Reopen the source file in your code editor. 

2. Make changes to the source code as shown in 
Listing 9-2. Note that the lines to be modified 
are shown at -* 1 and -> 2. The blocks of code 
shown here should be added. 



#i ncl ude 
#i ncl ude 



<stdi o . h> 
<string.h> 



// This will be our macro 
#define COPY_AND_TRUNC(ns 

it ( strlen(s) > 20 ) 

I \ 

ns = new char[ 
memset( ns, 0, 
strncpy( ns, s 

} \ 

el se \ 
I \ 

ns = new char[ 



versi on 

s) \ 

\ 



20 
20 



]; 
); 



20-1 



memset( 
strcpy ( 



ns , 
ns , 



strl en ( s ) 
strl en ( s ) 
); \ 



} \ 

delete s; 
s = NULL; 



\ 



char *copy_and_truncate( char *& s ) 
1 

char *temp = NULL; 
if ( strlen(s) > 20 ) 
{ 

temp = new cha r[ 20 ] ; 
memset( temp , 0 , 20 ) ; 
strncpy( temp, s, 20-1 ); 



el se 



} 



temp = new char[ strlen(s) ]; 
memset( temp, 0, strlen(s) ); 
strcpy ( temp , s ) ; 



delete s; 
s = NULL; 
return temp; 



int maind'nt argc, char **argv ) 



char *s = new char[80]; 

strcpy( s, "This is a really long string 

to test somethi ng" ) ; 
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char *ns = NULL; 
COPY_AND_TRUNC( ns, s ); 
printf("New string: [%s]\n", ns ); 
har[80] ; 

s is a really long 
omethi ng" ) ; 
COPY_AND_TRUNC( s2, s2 ); 
printf("New string: [%s]\n", s2 ); 
char *s3 = new char[80]; 
strcpyt s3, "This is a really long 
string to test something"); 
s3 = copy_and_truncate( s3 ); 
printfC'New string: [%s]\n", s3 ); 



3. Save the source code in your source-code editor 
and close the source-code editor application. 

4. Compile the program using your favorite com- 
piler on your favorite operating system. 

If you have done everything properly, this time 
you should see the following output in your con- 
sole window: 



$ ./a.exe 
New string: 
New string: 
New string: 



[This is 
[(null )] 
[This is 



a real 1 y 1 o] 



a real 1 y 1 o] 



Note that this time, your function did exactly what 
you expected it to do. Not only did you not wipe out 
your pointer, you also did not cause the memory 
leak that the previous version caused. Okay, imagine 
having to hassle with macros like that over and over 
just to get your work done. To avoid all that aggrava- 



tion, I recommend choosing functions for anything 
but the very simplest macros. The function shown in 
the modified code causes no problems, whereas the 
macros in the initial listing do. This should illustrate 
the problems caused unintentionally by macros. 

Using Macros Appropriated} 

What are macros good for, then? Remember, a macro 
is nothing more (and nothing less) than syntactical 
sugar; it's easy to wind up with too much of a good 
thing. Using a heap of macros may make reading 
your coding easier, but you should never modify 
your code itself with a macro. For example, if you 
have a particularly complex expression — such as 
( * i t e r ) . c_s t r ( ) — which can occur when you're 
using the Standard Template Library (STL) in C++ — 
you could create a macro that says: 

#define PTR(x) (*x) 

Then you can write PT R ( x ) . c_s t r ( ) , and however 
often you write it, the definition will be consistent. 
This isn't a complicated example, but it gives you an 
idea of when and when not to use macros in your 
C++ applications. The macro is straightforward, has 
no side effects, and makes the code easier to read 
later. These are all good reasons to use a macro. 



If you are trying to generalize a block of code, 
use templates instead of macros. Your finished 
source code is more compact that way, and 
debugging considerations are easier. 
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The s i zeof operator is not technically a part of the pre-processor, 
but it should be thought of as one. The si zeof operator, as its 
name implies, returns the size, in bytes, of a given piece of informa- 
tion in your application. It can be used on basic types — such as i nt, 
1 ong, f 1 oat, doubl e, or char * — and on objects, classes, and allocated 
blocks as well. In fact, anything that is a legitimate type can be passed to 
the sizeof function. 

The si zeof function is extremely useful. If (for example) you want to allo- 
cate a block of memory to hold exactly one specific type of data, you can 
use the si zeof function to determine how many bytes you need to allocate, 
like this: 

int bytes = si zeof ( bl ock ) ; 

char *newBlock = new char[bytes] ; 

memcpy( newBlock, block, bytes ); 



This capability is also useful when you're saving an object into memory 
while performing a global undo function. You save the state of the object 
each time it's going to change, and then return it to that saved state by 
simply copying the block of memory over it. There are other ways to do 
this task, of course, but this one is simple and very extensible. 

In the following sections, I show you what si zeof can and cannot do. 



Using the s/zeaf Function 

The si zeof function can be valuable in determining system configurations, 
sizes of classes, and illustrating many of the internals of the C++ system. 
The following steps show you how the sizeof function is used, and how it 
can show you something about the internals of your own code: 

/. In the code editor of your choice, create a new file to hold the code 
for the source file of the technique. 



In this example, the file is named chlO . cpp, although you can use 
whatever you choose. 



Using the sizeof Function 



2. Type the code from Listing 10-1 into your file. 

Better yet, copy the code from the source file on 
skicctrusajaipn Web site. 



// Basic types 




#include <stdio.h> 
#i include <string> 

class Foo 

{ 

public: 

FooO {); 
-Foot) {); 



class Bar 

{ 

public: 

BarO { I; 

vi rtual ~Bar( ) { 1 ; 



pri ntf 
si zeof 
pri ntf 
si zeof 
p r i n t f 
pri ntf 
pri ntf 
si zeof 
p r i n t f 
sizeof 

pri ntf 
) ; 

pri ntf 
sizeof 
p r i n t f 
si zeof 
p r i n t f 
si zeof 
pri ntf 
si zeof 



M\n" , 



i nt : %d\n" , si zeof (x) ) ; 
long: %d\n", sizeof(y)): 
float: %d\n". 



"size of char: %d\n", 
char) ) ; 
"size of char 
char *) ) ; 
"size of 
"size of 
"size of 
z)); 

"size of doubl e : %d\n " , 
d)); 

"size of string: %d\n", sizeof(s) 

"size of Foo: %d\n", 
Foo)); 

"size of Bar: %d\n", 
Bar) ) ; 

"si ze of Ful 1 : %d\n" , 
Full)); 

"size of Derived: %d\n", 
Deri ved ) ) ; 



class Ful 1 



int x; 
doubl e y ; 
public: 

Ful 1 ( ) 

I 

} 

vi rtual ~Ful 1 ( ) 



}; 

class Derived : public Foo 

{ 

publ i c : 

DerivedO {); 
-DerivedO {); 



int mainU 

{ 

int x = 0; 

1 ong y = 0 ; 

float z = 0; 

double d = 0.0; 

std : : stri ng s = "hello"; 



3. 
4. 

S, Run the program 



Save the source code as a file in the code editor 
and then close the editor application. 

Compile the program, using your favorite com- 
piler on your favorite operating system. 



If you have done everything properly, you should 
see the following output in your console window: 

$ ./a.exe 
size of char: 1 
size of char *: 4 
size of int: 4 
size of long: 4 
size of float: 4 
size of double: 8 
size of string: 4 
size of Foo: 1 
size of Bar: 4 
si ze of Ful 1 : 16 
size of Derived: 1 



Technique 10: Understanding sizeof 





You can see from the output the number of bytes 
that each of the elements we print up occupy in 
memoui^or this program. There are no real sur- 

size of the classes. Let's 
suits mean. 

Evaluating the Results 

There are some interesting conclusions to be made 
from this output. For example, although some of the 
results are not surprising at all (for instance, that the 
size of a character field is 1 byte), some surprises 
crop up — for example, the size of a character 
pointer is the same as any other pointer, which turns 
out to be the size of a 1 on g. That means the maxi- 
mum allowable number of bytes you can allocate 
using standard pointers is 4 bytes worth — 32 bits. 
(That's why Microsoft Windows is a 32-bit operating 
system. But you knew that.) 



You can save a lot of debugging time and 
design effort by remembering one handy rule: 
Always check the size of the values you are 
working with. Rather than hard-code into your 
application numbers specifically for reading 
bytes, words, and floating-point values, use the 
sizeof function to get the correct sizes for 
the compiler, platform, and operating system 
you are using. 



The next surprise is lurking among the objects in the 
list: The size of a string is shown as 4 bytes, which 
can't possibly be right — the string it's storing is 
longer than that. How can that be? The answer is that 
the si zeof function returns the number of bytes 
directly allocated by the object — that is, the number 
of bytes occupied by the private and public variables 
in the object, plus a few bytes for virtual functions 
(such as those in the Foo and Bar classes). Notice 
that even though the Bar class has no member vari- 
ables, it still takes up 4 bytes because it needs the 
virtual function table (or v-table) discussed earlier in 
Technique 2. Now, why does the Foo class take up 1 
byte, when it has no virtual methods and no member 
variables? The answer is that the sizeof function is 




required to return at least 1 byte for every class. This 
is to ensure the address of one object will never be the 
same as the address of another object. If C++ permit- 
ted objects to have zero size, the compiler wouldn't 
be forced to assign those objects a new address in 
memory. To illustrate, if I wrote the following: 

Foo fl; 
Foo fZ; 

the compiler would be free to make both of these 
objects point at the same location in memory. This is 
not desirable, even if neither object had any memory 
allocated to it. Having two objects with the same loca- 
tion would break too many standard library functions. 
Any function that compared source and destination 
(for example) would be broken, even if that breakage 
caused no real harm. The reason for this is that com- 
parison is done by looking at the addresses the two 
pointers occupy in memory. If the two addresses are 
the same, the assumption is that what they point at is 
the same. If two objects have no data in them, but 
occupy the same position in memory, they are not the 
same, even if they seem to be. 

The Bar class also contains no member variables, 
but contains a virtual function, and thus pushes the 
number of allocated bytes to 4. That way of working 
suggests that there is something very physical about 
virtual functions, and that you have to incur a mem- 
ory cost to use that feature. 



Even in programming, there is no such 
thing as a free lunch. 



The Ful 1 class contains several member variables — 
a double that takes up 8 bytes, and an integer that 
takes up 4 — and yet it has 16 allocated bytes. 
Where do the other 4 bytes come from? You guessed 
it: from the infamous virtual table, which is created 
by that virtual destructor. What does this tell us? 
Even if you don't have a "normal" virtual method, 
having a virtual destructor still creates a v-table 
entry — and that means 4 more bytes in the 
allocation. 
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The Deri ved class is puzzling — it looks like it ought 
to eat up more size than it does. When you look care- 
fully ayjtis class, however, you realize that it contains 
IfKfllfctJOV Irfd^ither does the base class 
fs^dffl-Kwl^) once again, here is an 
example of an empty class that takes up a single byte. 

Using sizeof With Pointers 

No discussion of the si zeof function would be quite 
complete without a look at a common mistake that 
C++ programmers make when they use the function. 
Consider the following little program: 

#include <stdio.h> 
#incl ude <stdl ib. h> 

const char arr[] = "hello"; 
const char *cp = arr; 



main( ) { 



printf("Size of array %d\n", 
sizeof (arr) ) ; 

printf("Size of pointer %dn", 
sizeof (cp) ) ; 

return ( 0 ) ; 



Because one statement outputs the size of an array 
and the other the size of a pointer to that array, you 
would think that the two pri ntf statements in this 
little program would display the same values. But 
they do not. In fact, if you take a look at the output, 
it looks like this: 

Size of array 6 
Size of pointer 4 



111 



The C++ language offers no way to get the 
size of an array from a single pointer. If 
you try to use the sizeof operator for 
that purpose, it will return a valid result 
but won't give you what you want. 



The size of an array is known at compile time and 
can be displayed by the si zeof function. On the 
other hand, a pointer is always the size of a pointer, 
no matter what it's pointing at. Furthermore, if you 
try to return the size of an array by including the 
statement sizeof(*cp) where cp is the array, you'll 
find that the answer is (again) not 6 but 1. Oops. 
Why is this? Because the expression *cp evaluates to 
a character, and the size of a single character is 
always one byte. Be very careful if you're trying to 
use the si zeof function on pointers — especially if 
you want to use the result to represent the size of 
what's being pointed at. 
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In C++, types are separated into two regions, basic and user-defined. 
Basic types are those defined by the language, which generally are 
modeled on types supported directly by the computer hardware. 
These types include integers, floating point numbers, and characters. 
Advanced types, such as strings, structures, and classes, fall into the 
user-defined region. In this technique, we examine the first region, the 
basic type. I save the advanced types for the next technique. 

How many times have you written a program that required a basic inte- 
ger variable to be constrained within a given range? You end up duplicat- 
ing the same code over and over throughout your application, in blocks 
that look like this: 

int value = get_a_val ue( ) ; 

if ( value < 0 | | val ue > 10 ) 

( 

pri ntf ( " i nval i d input, try again\n"); 
return false; 



Of course, after you have shoehorned all these blocks into the code, your 
boss comes along and tells you that the folks in the accounting depart- 
ment have decided that ten is no longer the magic number — now it's 12. 
So, you modify all of the code, learning something in the process — 
namely that you're better off using constants in this situation than vari- 
ables. Your modifications look like this: 



const i nt maxVal ue 



12; 



int value = get_a_val ue( ) ; 

if ( value < 0 || value > maxValue ) 



pri ntf (" i nval i d input, try again\n"); 
return false; 



You check the code into your source-code repository and sure enough, 
the boss comes into your office again. The accountants have requested 
another change. While the maximum allowable value is still 12, zeroes 
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you rei 
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are not allowed in the accounting system. The small- 
est value you are permitted to enter is 1. Grumbling, 
you rewHte the code one more time (taking advan- 
fl*il©/^i^ntiiafli@ned in the first two experi- 
eVtwg slightly more generic: 



const int minValue = 1; 
const int maxValue = 12; 

int value = get_a_val ue( ) ; 
if ( value < minValue (( value > maxValue 
) 

{ 

pri ntf ( " i nval i d input, try again\n"); 
return false; 



Implementing the Range Class 

In this technique, I show you a more general way to 
solve this problem — by using a C++ class. The idea is 
to just extend the basic type of i nt to allow for mini- 
mum and maximum values. The problem, of course, is 
that I still want to be able to use other types (such as 
i ntegers) for comparisons and assignments and the 
like. The class created in the following steps handles 
minimum and maximum values, and restricts input 
within those values. 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named chll .cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 11-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



pri vate : 

int i M i n ; 
int iMax; 
int i Value; 

virtual void SetValue( int value ) 

{ 

if ( val ue < GetMin( ) ) 
value = GetMi n ( ) ; 

el se 

if ( val ue > GetMax( ) ) 
value = GetMax( ) ; 
i Val ue = value; 



publ i c : 

IntRange(void) 
{ 

iMin = 0; 

iMax = I NT_MAX ; 

i Val ue = i Mi n ; 

I 

IntRangeO'nt min, int max) 
1 

if ( min <= max ) 
1 

iMin = min; 
iMax = max; 

I 

el se 
1 

iMin = max; 
iMax = min; 

} 

i Value = i Mi n ; 

I 

IntRange( int min, int max, int value ) 
1 

if ( min <= max ) 
1 

iMin = min; 
iMax = max; 

I 

el se 



Listing 11-1: The Range Class 



i Mi n 



max ; 



^include <stdio.h> 
^include <stdlib.h> 
^include <limits.h> 

class IntRange 
{ 



iMax = min; 

I 

SetVal ue( val ue ) ; 

} 

IntRange( const IntRangeS aCopy ) 
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iMin = aCopy.iMin; 
iMax = aCopy.iMax; 
iValue = aCopy . i Val ue ; 
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virtual int GetMi n ( voi d ) 



ppt 1 1 r n 

} 

vi rtual i nt 


n Mi n ; 

GetMax( void) 




{ 

return 


i Max ; 




) 

// Define a 
IntRange& o 
{ 


few operators 
perator=(int value) 




SetVal u 
return 


e ( value ) ; 
*this; 




} 

IntRange& a 
{ 


perator=( doubl e value) 


SetVal u 
return 

} 


e( ( i nt)val ue ) ; 
*this; 




virtual int 
{ 


GetVal ue(void) const 


return 

1) ; 


i Val ue ; 




If you examine 


this code, you will find that it 



verifies that the value of an integer variable falls 
within a certain range. You can define your own 
minimum and maximum values for the range, and 
the class will ensure that any value assigned to 
that variable falls inside that range. 

The interesting part of this class is the last part, 
comprised of the lines below the Defi ne a few 
operators comment. This is where the power of 
C++'s extensibility shines. I have defined assign- 
ment operators so that our class can be used with 
the built-in types i nt and doubl e. Obviously, I 
could add additional types here, including strings 
and the like, but this is enough for right now. With 
this power, you can now use the Int Range class to 



store your data, sure that the value in the object 
will always be valid. That's a comfort, and it 
means there's no longer any reason to write code 
like the following: 

int x = get_a_val ue( ) ; 
if ( x < mi n | | x > max ) 
do_some_error ( ) ; 

Instead, I can simply write 

IntRange myRangeObj (mi n , max); 

myRangeObj = val ; 

int x = myRangeObj . GetVal ue( ) ; 

I don't have to check the returned value, because 
the code requires that it be correct. There is 
something else that I can do with this class, how- 
ever, and that is to define external operators for 
it. Being able to define an external operator is 
extremely beneficial because it allows users with 
no access to the source code of the class to cre- 
ate new ways to use the class. This is something 
absolutely unique to C++; no previous language 
has anything like it. Without having access to the 
source code for this class, we can override basic 
operations (such as less-than, greater-than, or 
equal-to) in our own code. The ability to add 
external operators makes it possible to add 
things the original programmer did not think of 
for the class operations. 

3, Add the code from Listing 1 1-2 to your source- 
code file. This code could easily be added at 
a later date, in a separate file, by a separate 
programmer. 



Listing 11-2: Range Class Operators 

bool operator< ( const IntRange& aRange, int 
aValue ) 

{ 

return aRange . GetVal ue( ) < aValue; 

} 

bool operator==(const IntRange& aRange, int 
aValue ) 

{ 

return aRange . GetVal ue( ) == aValue; 
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Save your source-code file and close the code 
editor. 



ye Class 



After you create a Range class, you should create a 
test driver that not only ensures that your code is 
correct, but also shows people how to use your code. 

Here I show you how to create a test driver that 
validates various kinds of input from the user, and 
illustrates how the Range class, as defined in the pre- 
vious section, is intended to be used. 

In the code editor of your choice, open the 
existing file to hold the code for your test 
program. 

In this example, I named the test program 

chll_l . cpp. 

2. Type the code from Listing 1 1-3 into your file. 

Better yet, copy the code from the source file 
in the chll directory of this book's companion 
Web site. 

Listing 11-2: The Range Class Test Driver 

int mainO'nt argc, char **argv) 
{ 

IntRange i 20 ( 0 , 20 ) ; 

for (int i=l; i<argc; ++i ) 
{ 

i 20 = atoi (argv[i ] ) ; 
pri ntf ( " Setti ng value to %s, value 
i s now %d\n" , argv[i ] , 
i20.GetVal ue( ) ); 

) 

i 20 = 13; 

if ( i 20 < 19 ) 

printf("The value is under 19\n"); 

el se 



printfC'The value is over 19\n"); 

if ( i 20 < 10 ) 

printf("The value is under 10\n"); 

el se 

printf("The value is over 10\n"); 

if ( i 20 == 13 ) 

printf("The value is 13\n"); 

el se 

printfC'The value is NOT 13\n"); 
return 0; 



3, Compile and run the application in the operat- 
ing system of your choice. 

If you have done everything right, you should 
see the following output in the shell window on 



your system: 




$ ./a. ex 


ie 1 2 -1 30 




Setti ng 


value to 1 , val u 


e is now 1 


Sett 


i ng 


value to 2 , val u 


e is now 2 


Sett 


i ng 


value to -1, val 


ue is now 0 


Sett 


i ng 


value to 30, val 


ue is now 20 


The 


value is under 19 




The 


value is over 10 




The 


value is 13 





As you can see, the Range class does not allow 
the values to be assigned outside of the valid 
entries we defined in our source code. 

Notice how the Range class can be used just as if 
it were a basic type that was a part of the lan- 
guage from the very start! This amazingly power- 
ful technique lets you do just about anything you 
want (in code, that is). It even makes possible 
the direct conversion of your own data types 
into the base type you are extending, in order to 
pass them directly to functions that expect the 
basic type. 
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Of course, although it is all well and good to create extensions of 
built-in types, the real goal of programming in C++ is to create new 
types that the language designers never thought about. For exam- 
ple, imagine that you need to work with a matrix in your program. A 
matrix is simply a two-dimensional array of values. In this technique, I 
show you how to create a new type, a Matri x class for use in graphics 
calculations. To do so, it pays to remember that users don't really have 
to understand how things work behind the scenes; if they can just use 
those new types as if they were a natural part of the language all along, 
users are much more likely to use the object and return to it again and 
again. For the C++ class system, that means our goal is to make the 
object into something that looks, feels, and acts like a basic type such as 
i nteger or f 1 oat. 



Let's start out with the basics of creating a Matrix class. This class will 
allow you (eventually) to do basic matrix algebra — such as adding two 
matrices, adding or multiplying a constant to a matrix, and the like. The 
best syntax for our Matrix class would be one that closely emulates real- 
world matrices — that is, something like this: 



Matrix m(10,10) ; 
M[5][5] = 20.0; 



This code would define a 10 x 10 matrix and allocate space for it. The ele- 
ment at 5,5 would then be set to the value of 20.0, and all other elements 
would be set to the value of 0.0 (which is the default). We could, for 
example, create a derived class that implemented an identity matrix, 
where the diagonal values of the matrix from left to right are set to 1.0 
and all other values are set to 0.0. 

Immediately, however, we run into a very serious problem. Although it's 
possible — in fact, fairly easy — to override the [ ] operator for a class, it 
is not possible to override the operator [ ] [ ] (or [][][], or any other 
number of levels of indirection for arrays). Given this limitation, how do 
we create a class that "looks" like it has a two-dimensional array built 
into it — and that you can access? The answer lies in some of the magic 
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of C++. To see how it's done, begin building the 
Matrix class by implementing the ability to treat a 
two-dimensional array as if it were a single object. 
ce/T\»/9bl^rs|5^u how. 




Creating the Afatrtr Class 

The Matrix class allows us to treat a two-dimensional 
array as if it were a single object. This class looks 
to the user as if it was a two-dimensional array of 
values, but it does error checking and allows the user 
to query the class for basic properties, such as the 
width and height of the matrix. To do this, the follow- 
ing steps show you how to create two separate 
classes, one that encapsulates a single row of the 
matrix, and one that holds arrays of those rows to 
implement the complete matrix. 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named chl2 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 12-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

3, Save the source file. 



// Initialize the column 
for ( int i=0; i<size; ++i ) 

Col umns . i nsert( Col umns . end ( ) , 

0.0 ); 

} 

Row( const Row& aCopy ) 

{ 

std : : vector< double > : : const_i terator 
iter; 

for ( iter = aCopy . Col umns . begi n () ; 
iter != 

aCopy . Col umns . end( ) ; ++iter ) 



doubl e d = (*i ter ) ; 

Col umns . i nsert( Col umns . end( ) , 



d) ; 



nt si ze( ) 

return Col umns . si ze( ) ; 

doubles operator []( i nt index) 

if ( index < 0 || index > Columns. 
sizeO ) 

throw "Array Index out of 
Bounds " ; 
return Columns[ index ]; 



class Matrix 



Listing 12-1: The Matrix Class 



^include <stdio.h> 
#i include <math.h> 
#i include <stdlib.h> 
#i include <vector> 

class Row 

{ 

private: 

std::vector< double > Columns; 
publ i c : 

Row( void ) 



Row( int size ) 



pri vate : 

std::vector< Row > Rows; 
publ i c : 

Matrix ( int rows, int cols ) 
I 

for ( int i=0; i<rows; ++i ) 

{ 

Row r( col s ) ; 

Rows.insert( Rows.endO, r ); 



Row& operator []( i nt index) 

{ 

if ( index < 0 | | index > Rows. 
sizeO ) 

throw "Array Index out of 

Bounds " ; 



Matrix Operations 




return Rows[ index ]: 

i cLP riot I 

oi^T 'nt^*0; r<Rows . si ze( ) ; ++r 

for ( int c=0; c<Rows [ r ] . si ze ( ] 
++c ) 

printft" %lf ", Rows[r][c] 
); 

pri ntf ( " \n" ) ; 

} 

nt RowCountU 

return Rows . si ze( ) ; 

i nt Col umnCount ( ) 

{ 

if ( Rows.sizeU ) 

return Rows[0] .size( ) ; 
return 0; 



The code in Listing 12-1 actually does almost 
nothing — except provide storage space for the 
matrix and provide methods for getting at that stor- 
age space. In this way, the code is a perfect example 
of object-oriented design and programming: The stor- 
age is allocated, the space is managed, and the data is 
hidden from the user. Otherwise the actual functional- 
ity of the object is external to the object (not a good 
idea). Note the use of two separate classes to allow 
the illusion of multiple array indices. It's worth a 
closer look at the way this sleight of hand works. 

When the user invokes the operator [] on the Matrix 
class, it really returns a Row object. Of course, this 
process is transparent to the user, who thinks that he 
or she is simply operating on a given array element 
within the matrix. After you obtain a Row element, you 
then use the operator [ ] on that object to return indi- 
vidual Col umn entries in the row. 



To the user, it looks like you're using a two- 
dimensional array. This same technique can be used 
to implement any number of levels of array you 
want. Just replace the double entries in the Col umn 
class with additional Col umn objects, and you have a 
multidimensional array class that can handle virtu- 
ally any number of dimensions. Considering how 
little work is needed to manage this trick in the 
code, it's pretty impressive work. 

Of course, the problem here is that although we do 
have the storage management of the matrix data 
solved, we don't actually do anything with it. Its all 
very well and good to set individual elements in a 
matrix, but what people really want are the opera- 
tions that make matrices what they are — addition, 
multiplication, and the like. So the real question is, 
how do we implement this when we have already 
written the class and added it to the system? That's 
where C++ saves our hash by letting us implement 
operators outside a class. In fact, we can do things 
that the original class designer never even thought 
about — with no impact on the original design of the 
class, and no need to modify the code that makes up 
that class. The next section takes a closer look at an 
operator that adds two matrices, and shows you 
how to make it work. 



Matrix Operations 



After we have the basic class in place to implement 
the data storage for the matrix, the next step is to 
implement the functionality to operate on matrices. 
First, let's add two matrices. The following steps show 
you how: 

f m Add the code from Listing 1 2-2 to your source 
file (or just grab the code from this book's 
companion Web site): 

These operations are outside of the basic function- 
ality of the class itself, so they are presented as 
separate listings. You could add them to the origi- 
nal file, create a new file to hold them, or put them 
in your application source code. For simplicity, I 
am just tacking them onto the original source file. 
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Listing 12-2: The Matrix Operators 



Matrix operator+( Matrix& ml, Matrix& m2 ) 



DropB0oks 

i -F ( ml D rtufP mint ( 



to check that the rows 
the two are the same, 
if ( ml . RowCount( ) != m2. RowCount( ) ) 
throw "Adding Matrices: Invalid 
Rows " ; 

if ( ml . Col umnCount ( ) ! = 
m2 . Col umnCount ( ) ) 
throw "Adding Matrices: Invalid 
Col umns " ; 

Matrix m( ml . RowCount ( ) , 

ml .Col umnCount ( ) ) ; 

for ( int r=0; r<ml . RowCount( ) ; ++ r ) 

{ 

for ( int c=0; c<ml . Col umnCount () ; 

++c ) 

m[r][c] = ml[r][c] + m2[r][c]; 



return m; 



2. Save the source-code file. 

Aside from its actual functionality, this little code 
snippet illustrates some important points. First, 
because the operator is defined outside the class, 
we can only use methods defined as public in the 
class when we're working on the data. Fortunately, 
as you can see by the code, those methods are all we 
really need. The "rules" for matrix addition are fairly 
simple — you just add the same row and column 
values for each matrix and put the result into the 
output matrix. Note that because we are returning 
an object, rather than a reference to an object, we 
need to worry about copying the object. If you are 
returning a C++ object, it will automatically invoke 
the constructor to create the initial object and then 
the copy constructor to return a copy of the object. 
Fortunately, the copy constructor is defined for the 
Matri x class. 



One problem with operators is that they have no 
real way to return errors to the calling program. For 
example, when you write: 

x = y + z; 

there is really no way to determine that an error 
occurred. When we add two integers, we can actu- 
ally cause all sorts of errors, such as underflows and 
overflows, but those are mostly hidden from the 
user. For this reason, the only way that we can indi- 
cate to the user that there was a problem is to throw 
an exception. This is a very hard decision to make in 
terms of design, because it raises the possibility of 
exceptions in any line where the end user writes 
code — as in this example: 

Matrix m3 = ml + m2; 

This line could throw an exception — in which case 
you'd have to enclose it in a t ry / c a t c h block — it 
could bounce you straight out of your application. 
Obviously, adding two matrices doesn't seem like 
the kind of thing you should be worrying about 
crashing your application. We could simply return a 
blank matrix if the bounds of both matrices were not 
the same; that would be another choice, but a more 
complicated one. Now you are getting a result you 
did not expect from a standard operation. This is 
one reason for not using overloaded operators; they 
often have side effects that really don't apply to 
"standard" types. 

Multiplying a Matrix 
by a Scalar Value 

As with the addition of two matrices, we can also 
multiply a matrix by a scalar value. This operation is 
actually easier to code than the addition of two 
matrices, but has an additional side effect that's 
worth talking about — in a minute. The first order of 
business is to code the operation. To multiply a 
matrix by a scalar value, follow these steps: 



Multiplying a Matrix by Scalar Values, Take 2 



f m Using your code editor, reopen the source-code 
file for this technique and add the contents of 



Matrix operator*(Matrix& ml, double scalar) 

( 

Matrix m( ml . RowCount( ) , 

ml .Col umnCount( ) ) ; 

for ( int r=0; r<ml . RowCount ( ) ; ++ r ) 

{ 

for ( int c=0; c<ml . Col umnCount ( ) ; 
++c ) 

m[r][c] = ml[r][c] * scalar; 



return m; 



2. Save the source-code file. 

You can then use this code in your program — for 
example, by writing the following line: 



Matrix mZ 



ml 



This command will work fine, generating a matrix of 
the appropriate size that is the scalar multiple of the 
original matrix — and it will multiply all elements by 
4. The problem comes in when you try this: 



Matrix m2 



ml ; 



Oops. You've reversed the order of the operands — 
and suddenly there's a problem with the compiler. 
You get an error that says 

error: no match for 'operator*' in '4 * m4 ' 
error: candidates are: Matrix 
operator*(Matrix&, double) 

The reason that you get this error is that the com- 
piler takes the 4 * ml command and translates it to 
a call to operator*( i nt , Matrix& ml). You do not 
have this method defined. 



This is where the apparent magic of C++ gets tricky: 
C++ allows you to define operators for addition of 
classes that are as simple to use as adding two 
numbers (like 1+ 2). It can handle the simple stuff — 
scalar multiplication of integers, for example — and 
it understands that numbers can be multiplied in any 
order. The problem comes in when you try to apply 
that same concept to your own classes. You have to 
apply a few tricks of your own; in the next section, I 
show you how. 

Multiplying a Matrix by Scalar 
Values, Take 2 

To resolve this, we need to create a new operator, 
with virtually the same code, and place the argu- 
ments in the opposite order. The following steps 
show you how: 

Using your code editor, reopen the source-code 
file for this technique and modify the code as 
you see in Listing 12-4. 

Listing 12-4: Matrix Manipulation Functions 

Matrix seal ar_mul ti pi i cati on ( Matrix& ml, 
double scalar ) 

{ 

Matrix m( ml . RowCount( ) , 

ml .Col umnCount( ) ) ; 

for ( int r=0; r<ml . RowCount () ; ++ r ) 
{ 

for ( int c=0; c<ml . Col umnCount () ; 
++c ) 

m[r][c] = ml[r][c] * scalar; 



return m; 



) 



Matrix operator*(Matrix& ml, double scalar) 
{ 

return seal ar_mul ti pi i cati on( ml, scalar 
) ; 

} 

(continued) 
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Listing 12-4 (continued) 



Matrix operator*(doubl e scalar, Matrix& ml ) 
tiplicationt ml, scalar 
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Note that this code replaces the existing opera- 
tor* that we implemented earlier. Remove the 
existing implementation or you will get a dupli- 
cate definition error from the compiler for having 
two of the same methods defined. 



This code allows us to write either: 



f m In the code editor of your choice, open the 
existing file to hold the code for your test 
program. 

In this example, I named the test program 

chl2 . cpp. 

2, Type the code from Listing 12-5 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 12-5: The Matrix Test Driver 

i nt mai n ( ) 
( 

Matri x ml ( 5 , 5 ) ; 



Matrix m2 = 4 * 


ml; 


Matrix m2(5,5) ; 




Or 




rain 


2][2] = 3; 




Matrix m2 = ml 


. * 4; 


m2[ 
m2[ 


212] = 4; 
3][3] = 5; 




Because the compiler can resolve either order 
into a valid method, it will allow you to do both 


Mat 


rix m3 = ml + m2; 




in your code. Because the actual multiplication 


pri 


itf ( "Matrix 1 : \n" ) ; 





action is the same in either case, we factor out 
the code that does the "real" work and call it 
from both methods. This refactoring reduces the 
total amount of code, and makes it easier to 
track down problems. 

2. Save the source-code file. 



Testing the Matrix Class 

After you create a Matrix class, you should create 
a test driver that not only ensures that your code is 
correct, but also shows people how to use your 
code. 

Here's the procedure that creates a test driver that 
validates various kinds of input from the user, and 
illustrates how the Matrix class is intended to be 
used: 



ml . Print( ) ; 

pri ntf( "Matri x 3:\n"); 
m3 . Pri nt( ) ; 

Matrix m4 = m3 * 5; 
Matrix m5 = 4 * m4 ; 
pri ntf ( "Matri x 4 : \n" ) ; 
m4 . Pri nt( ) ; 

pri ntf ( "Matri x 5 : \n" ) ; 
m5 . Pri nt( ) ; 



3, Compile and run the application in the operat- 
ing system of your choice. 

If you have done everything right, you should 
see the output from Listing 12-6 in the shell win- 
dow on your system. 



Testing the Matrix Class 



Listing 12-6: Output from the Matrix Test Program 



Drop 



$ ./a.exe 
Mata** 1: 
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HOC 


vk 5 ^ 


0. 


.000000 


0. 


.000000 




,000000 0. 


.000000 


0. 


.000000 


0. 


.000000 




0.000000 












0. 


.000000 0 


.000000 


3 


.000000 


0 


.000000 




0.000000 












0. 


.000000 0 


.000000 


0 


.000000 


0 


.000000 




0.000000 












0. 


.000000 0 


.000000 


0. 


.000000 


0. 


.000000 




0.000000 












Matrix 3: 












0. 


.000000 0 


.000000 


0. 


.000000 


0. 


.000000 




0.000000 












0. 


.000000 0 


.000000 


0. 


.000000 


0. 


.000000 




0.000000 












0. 


.000000 0 


.000000 
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.000000 


0. 


.000000 




0.000000 












0. 


.000000 0 


.000000 


0. 


.000000 


5. 


.000000 




0.000000 












0. 


.000000 0 


.000000 


0. 


.000000 


0. 


.000000 




0.000000 












Matrix 4: 












0. 


.000000 0 


.000000 


0. 


.000000 


0. 


.000000 




0.000000 












0. 


.000000 0 


.000000 


0 


.000000 


0 


,000000 



0.000000 

0.000000 0.000000 35.000000 0.000000 
0.000000 

0.000000 0.000000 0.000000 25.000000 
0.000000 

0.000000 0.000000 0.000000 0.000000 
0.000000 



Matrix 5: 

0.000000 0.000000 0.000000 0.000000 
0.000000 

0.000000 0.000000 0.000000 0.000000 
0.000000 

0.000000 0.000000 140.000000 0.000000 
0.000000 

0.000000 0.000000 0.000000 100.000000 
0.000000 

0.000000 0.000000 0.000000 0.000000 
0.000000 



As you can see from the above output, we are dis- 
playing the individual matrix objects that are cre- 
ated in the test program. The output shows that the 
first matrix (ml) displays the data values which we 
placed into it in the line marked -> 1 in the test 
driver code. The line marked -* 2 shows the addi- 
tion of two matrices, which we then display as 
Matrix 3. Likewise, the code marked with 3 indi- 
cates the multiplication of a matrix by a scalar value, 
which is displayed in the output as Matrix 4. If you 
do the math, you will see that all of the output is cor- 
rect, indicating that our Matrix class and its manipu- 
lation methods are working properly. 

As you can see, the matrices display properly and 
the math is done correctly. We know our test pro- 
gram is correct, and we can use it in the future when 
we change things. 
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An enumeration is a language type introduced with the C language, 
which has migrated almost untouched into the C++ language. 
Enumerations are not true types, as classes are. You can't define 
operators for enumerations, nor can you change the way in which they 
behave. As with pre-processor commands, the enumeration command is 
really more of a syntactical sugar thing, replacing constant values with 
more readable names. It allows you slightly better readability, but does 
nothing to change the way your code works. Enumerations allow you to 
use meaningful names for values, and allow the compiler to do better 
type checking. The downside of an enumeration is that because it is sim- 
ply a syntactical replacement for a data value, you can easily fool the 
compiler by casting invalid values to the enumerated type. 



The basic form of an enumeration looks like this: 

enum <name> { 
va 1 uel [=number~\ , 
va 1 ueZ , 
va 1 ue3 , 



va 1 uen 

) Enumerati onTypeName ; 



where the <name> field is the enumeration type we are creating, the value 
parameters are the individual values defined in the enumeration, and 
number is an optional starting point to begin numbering the enumerated 
values. For example, take a look at this enumeration: 

enum color ( 

Red = 1. 

White = 2. 

Bl ue 
) ColorType; 



In this example, every time the compiler encounters Col orType : : Red in 
our application, it understands the value to be 1, Whi te would be 2, and 
Bl ue 3 (because the numbers are consecutive unless you specify 
otherwise). 



Implementing the Enumeration Class 



If enumerations actually do not change the logic of 
your code, why would you bother with them? The 
teason for £ numerations is to improve the 
illustrate this, here I 
involving enumera- 
tions you can use to make your code a little safer to 
use, and a lot easier to understand. 



primaoj^reason for £numeratioi 
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Enumerations are a great way to have the 
compiler enforce your valid values on the pro- 
grammer. Rather than checking after the fact 
to see whether the value is valid, you can let 
the compiler check at compile-time to validate 
that the input will be within the range you 
want. When you specify that a variable is of an 
enumerated type, the compiler ensures that 
the value is of that type, insisting that it be one 
of the values in the enumeration list. 



You might notice that enumerations are a simpler 
form of the Range validation class we developed in 
Technique 1 1 . Enumerations are enforced by the com- 
piler, not by your code, and require considerably less 
effort to implement than a Range checking class. At the 
same time, they are not as robust. Your mileage may 
vary, but enumerations are usually used more for read- 
ability and maintenance concerns than for validation. 



Implementing the Enumeration 
Class 

An enumeration is normally used when the real-world 
object it is modeling has very simple, very discrete 
values. The first example that immediately leaps to 
mind is a traffic light, which has three possible states: 
red, yellow, and green. In the following steps, let's cre- 
ate a simple example using the traffic light metaphor 
to illustrate how enumerations work and can be used 
in your application. 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named chl3 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 13-1 into your file. 

Better yet, copy the code you find on this book's 
companion Web site and change the names of the 
constants and variables as you choose. 

3, Save the source-code file. 



Listing 13-1: The Enumeration Program 



^include <stdio.h> 

typedef enum 
{ 

Red = 0, 

Yellow, 

Green 

) Traf f i cLi ghtCol or ; 

int ChangeLightt int color ) 
{ 

switch ( color ) 
{ 

case 1: // Red 

pri ntf ( "Changi ng light to RED. Stop!!\n"); 

break; 
case 2: // Yellow 

pri ntf( "Changing light to YELLOW. Slow down\n"); 

break; 
case 3: // Green 



(continued) 
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Listing 13-1 (continued) 

pri ntf ( "Changi ng light to GREEN. Go for it\n"); 
nvalid light state. Crashi ng\n " ) ; 



return 0; 



int ChangeLi ghtEnum( Traf f i cLi ghtCol or color ) 

{ 

switch ( color ) 

{ 

case Red: // Red 

pri ntf ( "Changi ng light to RED. Stop! !\n") ; 

break ; 
case Yellow: // Yellow 

pri ntf ( "Changi ng light to YELLOW. Slow down\n"); 

break ; 
case Green: // Green 

pri ntf ( "Changi ng light to GREEN. Go for it\n"); 

break ; 

} 

return 0; 

} 

Testing the Enumeration Class 

f. Add the following code to test the enumeration 
and validate that it is working properly: 

This code could easily be moved to a separate 
file. It is placed in one file simply as a conven- 
ience. The code illustrates why enumerations are 
more type-safe than basic integer types, and why 
you might want to use enumerations over the 
basic types. 

int maind'nt argc, char **argv) 

{ 

int c 1 r = - 1 ; 
ChangeLi ght( cl r ) ; 

f raff i cLi ghtCol or c = Red; 
ChangeLi ghtEnum( c ) ; 

return 0; 

I 




2, Save the source-code file and close the code 
editor. 

3, Compile and run the application with your 
favorite compiler on your favorite operating 
system. 

If you have done everything right, you should see 
the following output on the shell window: 

$ ./a.exe 

Invalid light state. Crashing 
Changing light to RED. Stop!! 

Whenever you use an integer value for input to 
a function — and that input value is intended 
to be mapped directly to a real-world set of 
values — use an enumeration rather than a 
simple integer. Remember to use meaningful 
names for your enumeration values to help the 
application programmers understand what val- 
ues they are sending to your functions and 
methods. This will save you time and effort and 
will make your code more self-documenting, 
which is always a good thing. 
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One of the most interesting constructs created for the C program- 
ming language was the structure. Because it allowed the developer 
to group a bunch of related data together, and to pass that data 
around to various functions, the C++ struct construct was the beginning 
of encapsulation for the language. 

When the C++ language was being designed, the structure was the primary 
component — in fact, C++ classes are simply extensions of the structure. 
The original C++ "compilers" were really translator programs that took C++ 
code and rewrote it into C, which was then compiled using the standard 
compiler for that language. This required that all physical parts of the 
classes be able to be implemented in structures. The C++ struct construct, 
in fact, is a class in which all members are public. 

Structures still exist in C++. In fact, a structure is really just a class that 
makes all of its data members public by default. Contrast that with a 
standard class, which has all members designated private by default. 
There is really no difference between 

struct foo { 

int x; 

int y; 

) ; 

and 

class foo 

1 

publ i c : 
int x ; 
int y; 



Here C++ has anadvantage: You can do more with structures in C++ than 
you could in C. Structures can contain constructors and accessor meth- 
ods. They can even contain methods that do not operate on the data of the 
class itself. You can even have structures derived from other structures. 
Although the original C++ compilers converted classes into structures, the 
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Technique lit: Creating and Using Structures 



newer compilers differentiate between the two. A 
class is still a struct, but the interpretation is differ- 
ent. A C±±.struct is no longer completely backward- 



ent. A (j± struct is do long( 

DropBooks 
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WHat can 't you do with structures? For one thing, 
you can't have virtual methods. Structures do not 
contain predefined v-tables, so they cannot contain a 
virtual function. Obviously, that means you can't 
override methods in the "base structure" for a 
derived structure. It also means that they cannot 
have virtual destructors. 



r 

A, 



Structures are a great way to use C++ without 
drawbacks such as huge overhead from 
classes, overloaded operators, and the like. In 
addition, because they are fully backward- 
compatible with C code, structures provide a 
great interface to existing legacy code. By 
adding elements like constructors to your 
structures for initialization, you can get the 
best of the old world and the new. The con- 
structor allows you to make sure that all of the 
elements of the structure contain valid values 
at all times, which was not true of the original 
C style structure. 



Implementing Structures 

In this section, I explore the way to implement struc- 
tures in C++, as well as what you can — and can't — 
do with them. In this technique, we will look at the 
original C style structure, the enhanced C++ structure 
with initialization, and a more complete C++ structure 
that contains methods. 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named chl4 . cpp, 
although you can use whatever you choose. 

2. Type the code below into your file. 

typedef struct cl assi c_c_structure 



i n t x ; 
int y; 
} POINT; 

This will be the "standard" structure as it is 
implemented in C. Now, let's try the same thing 
in C++, with a little enhancement to take advan- 
tage of what the language offers. 

3, Append the following structure definition to 
your source-code file, using your favorite code 
editor: 

typedef struct c_pl us_pl us_structure 
( 

int x ; 
int y; 

c_pl us_pl us_structure( ) 
{ 

x = 0; 
y = 0; 

} 

} CPP_P0INT; 

The structure listed in the code above is the same 
as the previous one, but it contains a constructor 
that will automatically initialize the values within 
the structure, an otherwise common oversight 
among programmers. 

4. Append the following structure definition to 
your source-code file, using your favorite code 
editor: 

typedef struct c_pl us_pl us_enhanced 
{ 

int x ; 
int y; 

c_pl us_pl us_enhanced ( ) 
{ 

x = 0; 
y = 0; 

} 

void p r i n t ( ) 

{ 

pri ntf ( "x = %d\n" , x ) ; 
pri ntf ( "y = %d\n " , y ) ; 



} CPP_P0INTE; 



Interpreting the Output 



In this case, we have simply extended our C++ 
structure to have another method that allows us 
>^iump the d^ata values of the class. 

ructure to the file. Enter 
'nto your code editor. 

This code will show you how derivation is han- 
dled in C++ for structures: 




typedef struct new_struct 
CPP_POINTE 

{ 

int version; 

new_struct ( ) 

{ 

version = 1; 



publ i c 



-> 2 



POINT p; 
CPP_P0INT pi; 
CPP_POINTE p2; 
NEW_P0INT p3; 

printf ("P0INT:\n") ; 
pri ntf ( "X : %d\n" , p . x) ; 
pri ntf ( "Y : %d\n" , p .y ) ; 

printf ("POINT l:\rT); 
pri ntf ( "X : %d\n" , pi . x) ; 
pri ntf ( "Y : %d\n" , pi .y ) ; 

printf ( "POINT 2:\n"); 
pri nt_poi nt ( p2 ) ; 

printf ("POINT 3:\n") ; 
pri nt_poi nt ( p3 ) ; 



void pri nt() 

{ 

CPP_POINTE: :print() ; 
pri ntf ( "versi on = %d\n", 
versi on ) ; 
} 

) NEW_P0INT; 
6. Save the source-code file. 

Interpreting the Output 

After you have the actual code for your structure 
implemented, you should test it to illustrate how it is 
to be used, and to validate that it is working properly. 

f m Add the code from Listing 14-1 to your source- 
code file, immediately below the structure 
definitions. 

Listing 14-1: The Structure Test Harness 

void print_point( CPP_POINTE& p) 

{ 

p . pri nt ( ) ; 

} 

int maintint argc, char **argv) 

{ 



This code simply exercises the various structures 
that we have defined in the source file. You will be 
able to see what happens when the initialization 
process is done and when it is not. 

2, Save the source-code file and close the code 
editor. 

3. Compile and run the program, using your 
favorite compiler on your favorite operating 
system. 

If you have done everything properly, you should 
see the following output on your shell window: 



$ 

PO 


./a 

INT 


. exe 


X: 


2289768 


Y: 


16; 


'7507534 


PO 


INT 


1: 


X: 


0 




Y: 


0 




PO 


INT 


2: 


X ' 


= 0 




y ■ 


= 0 




PO 


INT 


3: 


X 1 


= 0 




y - 


= 0 





Technique Ik: Creating and Using Structures 



There are a few things to notice here. First of all, 
you can see why failing to initialize the data values 
of a structure is a bad idea (see the lines indicated 
~ie classic C-style struc- 
lat could easily cause seri- 
ous problems in an application. 
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Always initialize all values in classes or struc- 
tures to avoid serious problems later in the 
application. 



Imagine how much worse it would be if the structure 
contained pointers: Pointers that are not initialized 
to point at something will either be pointing at an 
invalid part of memory or worse, to a part of mem- 
ory that should not be modified. 

Notice that when we added a constructor to the 
structure, our enhanced version called the construc- 
tor (-* 2) automatically for the class, as you would 
expect. That way the structure elements were initial- 
ized without requiring any work from the user. 
Naturally, you can have constructors that take argu- 
ments as well. 



Always implement a constructor for all struc- 
tures in your C++ code. If you do not, the 
structure elements will contain random data 
values. 




It's handy to dump the data values for a structure 
quickly and easily without cluttering the program 
with pri ntf statements — as the third variant of 
the structure illustrates with its pri nt( ) member 
function. Of course, we could have easily written 
a function that accepted a structure of the proper 
type to print it out (as we did with the second type), 
but then it would have to appear everywhere the 
structure was used. 

With the derived structure (new_struct), there are 
some interesting things to notice. First, because we 
can't override the function print within the base class, 
the structure doesn't print out data that is only in the 
derived class. This is due to the limitation of no vir- 
tual tables in structures. We can, however, pass this 
structure to anything that accepts its base class — 
just as we could with a normal class. In this way, the 
structure "acts" like a class. 



Because the base class members are always 
public, we can access them from either the 
structure method itself, or from the external 
program. This is quite different from a class, 
where you would have to have accessor meth- 
ods to get or set the data. 
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Pity the poor, misunderstood C++ constant — there are so very many 
ways to use it, yet so few of them are really understood. By using 
the constant (or const statement) construct in your code, your 
applications can be made safer, more readable, and more efficient. Yet, 
programmers are often so overwhelmed by the incredible number of dif- 
ferent ways in which they can use constants that they simply avoid the 
construct completely, allowing the compiler to pick and choose what can 
change and what cannot in the application. A word to the wise: Allowing 
the compiler to make choices for you is very rarely a good idea. 

Constants provide a way to self-document your code, as well as a 



p- I -a) simple way to locate all of the definitions of values in your program. 



By utilizing constants for your data values, you can make quick, easy, 
simultaneous changes across the scope of your application. In addi- 
tion, you can enforce what does and does not change in the methods 
and functions of your application by using the const keyword. 

In this technique I explore the various possibilities for working with con- 
stants in C++ and what they mean to you as an application developer. 



To best understand how constants work and how you can utilize them 
in your application, the following steps show you a simple example of 
defining various kinds of constants. We will be creating a file that contains 
constants for use as whole numbers, floating point numbers, and charac- 
ter strings. You will see how a constant can directly replace a #def i ne 
value, as well as how the compiler can be used to do type-safe checking of 
constant assignments. 

f m In the code editor of your choice, create a new file to hold the code 
for the implementation of the source file. 

In this example, the file is named chl5 . cpp, although you can use 
whatever you choose. 




Defining Constants 
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2. Type the code from Listing 15-1 into your file. 

Better yet, copy the code from the source file on 
Tiaboak'sy^irnaBior] Web site. 




Listing 15-1: The Constants and Their Definitions 



#include <stdio.h> 
#i include <stdlib.h> 

// This is a constant value that can be used 
// in place of a #define value 

const int MaxValues = 100; 

// Unlike the #define, you can use a const 
// for typesafe constants 

const char *StringName = "Matt Telles"; 
const double Cost = 100.35; 
const long MaxLong = 1000000; 



You can define constants of pretty much any 
shape or size. Constants can be numbers, 
strings, characters, or floats. More importantly, 
the compiler will check for type safety when you 
assign a constant to another value. For example, 
you're permitted to assign string values to string 
constants, like this: 

string myString = StringName; 

You are not, however, permitted to assign MaxLong 
values to integers, which would look like this: 

int iVal = MaxLong; // The compiler will 
compl ai n . 

3. Save the source-code file. 

Of course (so far), all adding the constants has 
really done is give us another way to replace the 
#def i ne statement in our application. The real 
meat of the C++ constant is giving the compiler 
directives in your functions and classes, as I 
show you in the next section. 



Implementing Constant 
Variables 

The const statement can also be used to tell the 
compiler that something is not permitted to change, 
as we will see in this simple technique that relies on 
another facet of the const keyword. Follow these 
steps to see how it all works: 

Append the code from Listing 15-2 to your 
source-code file. 

Listing15-2: A Function with an Immutable Argument 

// Functions can take constant arguments, 

allowing them 
// to guarantee that values don't change. 

int func( const int& x ) 
I 

// We can do this 
int z = x ; 

// We cannot do this. Compile Error: 

//x = 10; 1 



return x; 



This function accepts a single argument of type 
const int reference. The const modifier indi- 
cates to the compiler that the input argument 
cannot be modified. If you were to uncomment 
the line marked -* 1, you would see the compiler 
generate an error telling you that you cannot 
modify a constant reference. 

This example looks at a function that accepts a 
single-integer argument, the constant x. We are 
informing both the user of the function and the 
compiler that this function will never change the 
value of that argument, even if it is passed in by 
reference. This information is very important to 
the compiler; with this knowledge it can optimize 
your function so that it does not have to pop the 



Implementing Constant Variabtes 
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value back off the stack and insure that the mem- 
ory location that it is using will not change. This 
lossible because this value can be thrown 
!y# a *i^'*'i4i (rr l^' c)n is done; after all, it could 
h/ljaVj^Janged . 

Proper use of the const modifier allows the 
compiler to generate closer-to-optimal code 
and generate better warnings, so you can 
write better applications and have fewer errors 
to fix in the debugging phase. 

Furthermore, because we know that the input is 
a constant, we can pass in values that are con- 
stant. For example, if the reference was not a 
constant, you'd have to write this: 

i n t x = 3 ; 

int myVal = func( x ) ; 



2. 



because the compiler would never allow you to 
write this: 



int my V a 1 



f unc(3) 



When you define the input argument as a con- 
stant, however, the compiler is now aware that 
the actual memory location that's holding your 
value (in this case, 3) will not change, and it will 
allow you to pass in the integer value without 
first assigning it to anything. This arrangement 
saves a few CPU cycles and some memory — and 
you don't have to write some silly code that 
doesn't really do anything. 

Using your code editor, append the code from 
Listing 15-3 to your source-code file. 

This technique illustrates how you can use the 
const keyword within a class to accomplish the 
same things that it does outside of a class listing. 



Listing 15-3: Constants in Classes 

// Classes can have constants in them 
const int MaxEntries = 10; 
class Foo 
{ 

int entries[ MaxEntries ]; 
publ i c : 

// You can pass in constant references to arguments 
Foo( ) 



Foo( const Foo& aCopy ) 
{ 

for ( int i=0; i <MaxEntri es ; ++i ) 
entries[i] = aCopy .entries[i ] ; 

) 

// You can return constant references from methods 

const int * getEntriesO 

{ 



return &entries[0]; 

) 

// You can indicate that a method will NOf change 

// anything in the object 

int getEntry( int index ) const 

{ 

return entries[index] ; 

(continued) 
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Listing 15-3 (continued) 



The two can be combined to say that the return value 
^ki^^tt/c^^iged and the object will not change 
l^iitol Ijad^mstEntry ( int index ) const 

return entries[index] ; 
} 

) ; 



DropB 



3, Save the source-code file and close the code 
editor. 

As you can see, the const construct is quite versatile. 
It can be used to indicate a value that is used to 
replace a number in your code. It can be used to indi- 
cate a return value that cannot be changed. It can 
indicate that a cl ass method accepts an argument 
that it doesn't change, such as the Copy constructor. 
Can you imagine writing a Copy constructor that 
changed the object it copied? That would be a little 
strange to say the least. Imagine writing something 
like this: 

Foo fl = f; 

Then imagine having the f object change out from 
under you — talk about your basic debugging night- 
mare. For this reason, it's customary to use a const 
reference, indicating that you won't change the 
object being copied. In the same manner, we can 
pass in values to methods and assure the user that 
they won't be copied (as in the f unc function we 
looked at earlier in Listing 15-2). 

Of course, if you can take an input value and assure 
the user that you will not change it, then the quid 
pro quo argument is that you must be able to give 
someone back a value and make sure that they don't 
change it. This is called returning a const reference. 
For example, if you have an internal variable, you 
could create a reference method that gave it back, 
but only in a read-only fashion. That is what the 
getEntries method does in Listing 15-3. It returns a 
const pointer that makes sure that the user doesn't 
change anything in the program that calls the object. 



Finally, you can tell the user that the method you are 
calling will never change the object. To do so, you 
simply append the const keyword at the end of the 
method, which allows your method to be called on 
const objects. Doing so also allows the compiler to 
avoid the overhead of having to make copies of 
objects and such. If the object cannot be changed 
via the method, there is no reason to worry about 
making the memory location static. 

Testing the Constant Application 

After you create the class, you should create a test 
driver that not only ensures that your code is correct, 
but also shows people how to use your code. 

In the code editor of your choice, open the 
existing file to hold the code for your test 
program. 

In this example, I named the test program 
chl5 . cpp. 

The next step (for wise programmers, and you 
know who you are) is to add a simple test driver 
to the source file so you can take a look at how 
all this plays out. 

2. Type the code from Listing 15-4 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 15-4: The Test Driver for Consts 

int maind'nt argc, char **argv) 

{ 

Foo f; 



Using the canst Keif Word 



Drop^ 



// Note that to get back the entries, we 

MUST define 
// our return type as constant 

*v n ' J - ^. l p J^Jrkf s = f • 9 e tEntries( ) ; -* 2 



return entries[index] ; 

) 

// Or not, depending on how you feel. 

int getEntryt int index ) 

{ 

return entries[ index ]; 



return 0; 



3. Save the source-code file and close the code 
editor. 

4. Compile the application with your favorite 
compiler on your favorite operating system. 

Notice that we must use a constant pointer 
(-> 2) to access the entries in the class, and that 
we cannot modify the values in that entry block 
passed back. The compiler reinforces both these 
conditions at compile-time. 

Thus you can see how const works in the C++ 
world — and how you can use it to enforce your 
application's demands on the end user. (In a good 
way, of course.) 

Using the const Keyword 

Here's another job for the versatile const keyword: 
You can use it as a differentiator to determine which 
method to use; the const keyword is a part of the 
signature of a method. That means you can have the 
two methods shown in Listing 15-5 in your class at 
the same time. The const keyword isn't interpreted 
by the user, but rather by the compiler to determine 
which method is being called. If the value is modifi- 
able, it will call the non-const version. If the value 
cannot be modified, it will call the const version. 



Listing 15-5: Using const to Differentiate Two Methods 

// You can indicate that a method will 

NOT change 
// anything in the object 
int getEntryt int index ) const -* 



The first of these methods can be used from any 
object, constant (-» 3) or otherwise (-»■ 4) . The sec- 
ond, on the other hand, can only be used from a non- 
const object. If you choose to call the second, you 
have to accept the risk that the user will directly 
modify the data within your class. 

Finally, it is worth pointing out that const is some- 
thing that can actually be cast away if the user 
explicitly chooses to do so. So, even if you create the 
getEntries method (as in Listing 15-3) — which 
requires you to use aconst int pointer to call the 
method — the programmer can get around this little 
problem by writing code like that in Listing 15-6. 

Listing 15-6: Casting Away Const-Ness 



// Now, you 
int *ent2 = 
ent2[2] = 2 



can break things this way 
(int *)f .getEntriest ) ; -> 5 



C++ always assumes that the programmer knows 
what he or she is doing, even if allowing some things 
to be done incorrectly (which violates the spirit of 
the language). By doing explicit casting (-» 5), you 
can "de-const" a pointer (that is, make a const 
pointer non-const) and do whatever you want. 
The compiler assumes that because you did the 
explicit cast, you knew exactly what the end result 
would be, and had figured out every possible ramifi- 
cation for the program as a whole. Such trust is 
touching — but not a good idea. If the pointer was 
defined to be constant in the first place, there was 
probably a good reason for it. In your own application 
development, avoid such a technique at all costs. 
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The concept of "scope" is fairly unique to the C and C++ languages. 
Scope, also called lifetime, is the period of the application during 
which a variable exists. Some variables can exist for the entire 
length of the program (and unfortunately, as with some memory leaks, 
well beyond that length), while others have very short periods — that is, 
less scope. The length of an object's or variable's lifetime is generally up 
to the developer, but sometimes you have to keep close watch on when a 
variable goes out of scope in your own applications. 

When implementing classes and objects, scope usually is handled auto- 
matically. An object starts to exist when its constructor is invoked, and 
ceases to exist when its destructor is invoked. Suppose (for example) an 
object of the Foo class is created on the stack with a command like this: 

Foo f; 

The Foo object will be automatically destroyed when the scope it exists 
in is destroyed. Consider the following example, with three different 
instances of the Foo class being created on the heap: 

Foo global_foo; // -* 1 

int mainO 



As you can see, three different Foo objects are created at different points 
in the application code. The first one, the gl obal_foo object (indicated at 
-> 1) is created before the application even starts, in the mai n function. 



Foo main_foo; // 



for ( int i=0; i < 1 0 ; ++i ) 



Foo loop_foo; // 



) // 



) // 
// 



Illustrating Scope 




The second, mai n_f oo (indicated at -* 2), is created 
at the start of the ma i n function, and the third, 

(indicated at -»> 3), exists in the for loop in 
i/5r|;tfe\ilj/r faction. The 1 oop_foo object 
eWiViml m^rogram cycles through the 
for loop — ten times in all. 

If we implemented the Foo class to tell us when the 
object was created, and on what line each object 
was destroyed , we could actually view this informa- 
tion visually and be able to understand the flow of 
the process. 

In the following section, I show you a simple way to 
do just that. 



publ i c : 

Foot long level ) 



Illustrating Scope 



Identifying an object's starting time and specific 
code line on-screen is one way to get an idea of its 
scope. Here's how to make it happen: 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named chl6 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 16-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

This code creates a very simple class that self- 
documents its creation and destruction 
processes. We will then use this class to see the 
order in which objects are created and destroyed 
in a real-world program setting. 

Listing 16-1: Illustrating Scope 

^include <stdio.h> 
#include <stdlib.h> 

class Foo 



pri ntf ( "Creati ng foo object %ld\n", 
1 evel ) ; 
_Level = 1 evel ; 



-Foot) 



pri ntf ( "Destroy i ng foo object 
%ld\n" , _Level ) ; 



3. Append the following code to your source-code 
file, using your code editor. 

Here we are simply creating a little test driver 
that illustrates how the objects are created and 
destroyed. You could easily place this code in a 
separate file, but for simplicity we will just add it 
all to the same file. 

This code illustrates the various levels of scope, 
gl obal , 1 ocal , and 1 oop, that an object can 
occupy within an application. 

Foo gl obal_foo(0) ; 

int main( ) 
{ 

Foo mai n_f oo( 1 ) ; 



for ( int i=0; i<3; ++i ) 
1 

Foo 1 oop_f oo( 2 ) ; 



} 



4. Save the file and close your code editor. 

5. Compile and run the application in the operat- 
ing system of your choice. 



private: 

1 ong _Level ; 



81, 



Technique 16: Scoping \lour Variables 



Interpreting the Output 




g right, you should see the 
11 window on your system: 



$ ./a 

Creat 
Creat 
Creat 
Destr 
Creat 
Destr 
Creat 
Destr 
Destr 
Destr 



. exe 
ing f 
ing f 
ing f 
oyi ng 
ing f 
oyi ng 
ing f 
oying 
oyi ng 
oyi ng 



oo object 0 
oo object 1 
oo object 2 

foo object 2 
oo object 2 

foo object 2 
oo object 2 
foo object 2 
foo object 1 
foo object 0 



Note that the order in which the variables are 
destroyed is exactly the reverse of the order in 
which they were created. This is due to the object's 
positions in the file: The last object created is the 
first one destroyed. Paying attention to when objects 
are created and destroyed in your program helps 
you optimize the use of memory, and also allows you 
to control when objects are available. For example, if 
an object used to create a file requires a filename, 
instantiating the object before the filename is avail- 
able doesn't make sense, even if the open method of 
the object is used well after the fact. Now, consider 
the following snippet of a program: 

int main( ) 



When will the Foo object be created? Obviously, the 
constructor is called on the line with the new func- 
tion call. However, it is not at all clear when the 
object is destroyed. If you were to run the program, 
you would see the following output: 

Creating foo object 10 

There will be no corresponding printout saying that 
the object was destroyed — because the object is 
never destroyed. For this reason, you should always 
be very careful either to create your objects on the 
heap (using the constructor and no new call), or 
match your calls to new and del ete for the object 
(in other words, if you allocate an object with new, 
deallocate it with del ete). If you do not delete all 
objects that you create, you will create memory 
leaks in your application, which can lead to program 
crashes, computer slowdowns, and a host of other 
unpredictable behavior. 

An alternative to this approach is the auto_ptr class 
of the Standard Template Library. This class holds a 
pointer to a given class, but it does so inside an 
object allocated on the heap. When the object on the 
heap goes out of scope, the object is destroyed. As 
part of that destruction, the pointer is deleted. This 
is really the best practical use of the scope concept 
in C++. 



Foo 



new Foo( 10 ) ; 



// Some other code 

} 
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Once upon a time, there was a language called C. It was a popular 
language that allowed people to create nice, reusable libraries of 
code — which they then sold in the marketplace for big bucks. 
Later on, this language was replaced by a language called C++, which also 
allowed programmers to create reusable code. Learning from the prob- 
lems of the past, C++, unlike C, also allowed you to package your code in 
classes, which solved one of C's very difficult problems: resolving func- 
tions with name conflicts. Because it is common to have different functions 
in different libraries that do similar things, it was inevitable that the names 
of those functions would be similar. By restricting those methods to 
different class names, it fixed the problem. Of course, that didn't help 
when the class names were the same, but we will discuss that problem in 
just a bit. 

Here is how the problem worked: Consider, for example, two libraries that 
exist in a C-style interface: one performs windowing functions; the other 
manages documents. In Library One, we have the following function: 

void SetTitlet char *sTitle ) 



// Set the title of the window to sTitle 
wi ndow->ti tl e = sTitle; 



In Library Two, the document library, we have the following function: 

void SetTitleC char *sTitle ) 

{ 

// Set the file name for the document 
_filename = sTitle; 

} 



Now, both of these functions have the same name and the same signature, 
but they have very different goals and code to implement them. 

Here we have two routines that do the same basic thing (setting a title) 
with different code — but that isn't the problem. The problem is that the 
linker in C (and also in C++) can't deal with this situation; it freaks out if 
two functions have the same name with the same signature. It could handle 
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that if you only wanted one of them, but that obvi- 
ously would not work. So, with the advent of classes, 
you'd thjj,^ all this wpuld be fixed, right? Nope. As 
afTfcjffgj larti^problems don't really go 
thmf]mifmar[x\%^a. different form. Of course, 
we'can fix this problem, it is just a matter of under- 
standing where the problem came from in the first 
place. The answer, in this case, is to create different 
classes to wrap the functions. 



Naming classes properly goes a long way 
toward saving you time when you're trying to 
link in multiple libraries from different sources. 
Always preface your classes with a known 
prefix (such as the company initials) to avoid 
problems. 



Fast-forward a bit to the C++ world. Programmers are 
still developing libraries, but now these are libraries 
of classes, rather than of simple functions. The basic 
problem of name conflict has not changed — but 
our example libraries (now updated in C++) have 
changed. The windowing library now implements 
classes to handle the all-new, all-different, model- 
view-controller concept. This concept allows you to 
work not only with documents but also with views of 
those documents. 



The concept of a document means the data for 
a displayed window is encapsulated in a class 
that can load the data from a file, save it to a 
file, and manipulate it for display purposes. 



Meanwhile, over in the document library, we have 
document classes that store text, formatting infor- 
mation, and preferences for document information. 
In the document library, the Document class is 
defined like this: 

class Document 



pri vate 
std 



:string filename; 
:vector< std::string > lines; 



pub 



std 
i c : 
Document! ) 
{ 
} 



Document( const char *_filename) 
{ 

filename = _filename; 

1 

bool ean Read ( ) ; 
Boolean Write( ) ; 



In the windowing library, however, the Document 
class is defined a bit differently: 

class Document 
{ 

private: 

std : : stri ng title; 

std::vector< Window *> windows; 
pub! i c : 

Document ( ) 



Documentt const char *_title ); 
void CreateWi ndow( ) ; 



While this is not as simple as the function example, 
the problem is exactly the same. When push comes 
to shove, the linker is going to need to resolve two 
different classes of the same name. This isn't possi- 
ble, so it is going to complain about it. How do you 
fix a conflict like this? The answer lies in the concept 
of C++ namespaces. 

Namespaces were created in C++ to address just this 
problem. While you might have a class that is in con- 
flict with another class, it would be extremely unlikely 
to have an entire library of classes that is in conflict. 
With proper naming of a namespace, you can avoid 
the entire problem of class name collision. 

Creating a Namespace 
Application 

The basic format of defining a namespace is as 
follows: 

namespace <name> { 

// some classes or definitions 



Creating a Namespace Application 



To illustrate how all this works, a quick look at some 
real code is in order, followed by a tour of the 
optionsjrou can use in your own code to fix name 
&i|a< 7Tt$ |GHcb<fh£%teps show you how: 




f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named chl7 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 17-1 into your file. 

Better yet, copy the code from the source file on 



this book's companion Web site. 

Listing 17-1: Using Namespaces 


#i include <stdic 


.h> 


#i include <stdli 


b.h> 


#i include <strir 


g> 


using namespace 


std ; 


namespace foo_v\ 


<i ndowi ng 


{ 

class window 


private: 




int wir 


dow_i d ; 


string 


title; 


publ i c : 




wi ndow( 


void) 


i 

window_id = 0; 


tit 


le = ""; 


windowtint id, const char *t) 
f 



window id 



id; 



title 



t; 



doc_id = 0; 
title = ""; 

) 

documenttint id, const char *t) 
{ 

doc_id = id; 
title = t; 



// End of namespace foo_wi ndowi ng 



Before we move on to the next step, let's take a 
look at the important features of this code that 
you can adapt to your own programs. 

First, notice the usi ng namespace statement up 
there at the top — normally you must fully qual- 
ify the names of all classes within any name- 
space you use. The string class for the Standard 
Template Library happens to "live" within the 
std namespace. When you utilize the using 
namespace std statement, you tell the compiler 
that you know what you're doing and that it 
should try the std : : namespace on anything it 
cannot immediately recognize. Of course, if you 
use all available namespaces, you avoid the 
problem of entering the namespace's name prefix 
on all your class names — but then you also run 
into the problem of name collisions again. That's 
why the compiler makes you qualify the name 
whenever there's any doubt. 

The next step takes a closer look at the second 
namespace we create (in this case, for the docu- 
ment classes). 

3, Modify your source code in the code editor as 
shown in Listing 17-2. 

Simply append this code to the end of your cur- 
rent source-code listing. 



class document 

{ 

private: 

int doc_id; 

string title; 
publ i c : 

document ( voi d ) 



Listing 17-2: Creating a New Namespace 

namespace bar_documents 
{ 

class document 
{ 

private: 

string filename; 



(continued) 
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Listing 17-2 (continued) 



publ i c : 

document (void) 




document(const char *fn) 

{ 

filename = f n ; 

) 

}; 

stri ng name( ) 
{ 

return filename; 

} 

); // End of namespace bar_documents 



document class represents a file on disk. 
Fortunately, by placing each of the classes in a 
different namespace, we can differentiate 
between the two classes easily so the compiler 
knows what we're talking about. A real applica- 
tion offers an example in the next section. 



Testing the Namespace 
Application 

The following list shows you the steps to create a 
test driver that validates various kinds of input from 
the user, and illustrates how namespaces are 
intended to be used. 



4. Save the source code in the source-code editor. 

As you can see, we have a definite name conflict 
if we use these two class sets together. They 
both define a class called document. Worse, the 
document class in one is very different from 
the document class in the other. In the first case, 
our document class represents the data being 
displayed in a window. In the second case, the 
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f m In the code editor of your choice, open the exist- 
ing file to hold the code for your test program. 

In this example, I named the test program 
chl7 . cpp. 

2, Type the code from Listing 17-3 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



// Let's default to the bar_documents namespace 
using namespace bar_documents ; 

void print_doc( documents d ) 
{ 

pri ntf ( " Recei ved file: %s\n", d . name( ) . c_str( ) ); 



int main( int argc, char **argv ) 
{ 

document d( "filel.txt") ; // Create a bar_documents document 
foo_wi ndowi ng :: document did, "this is a title"); 

// fhis is okay to do 
pri nt_doc( d ) ; 

// fhis would not be okay to do 
//print_doc( dl ) ; 



Testing the Namespace Application 




Here we've inserted a line to make the ba ^docu- 
ments namespace global — which means we 
in't have to .say bar_documents : :document 

the class. In fact (as you can 
: the main program), we sim- 
ply create a document via a standard usage of 
the Document class. When we want to use the 
f oo_wi ndowi ng namespace classes, however, we 
still have to fully qualify them as you can see in 
the second line of the main program. Likewise, 
we can pass a ba r_documents document to the 
function pri nt_doc, but we cannot do the same 
with a f oo_wi ndowi ng document. If you uncom- 
ment the line that calls pri nt_doc with the 
f oo_wi ndowi ng document object, you will get the 
compile-time error shown in Listing 17-4. 

3. Save your source-code file and close the code 
editor. 

4. Compile the file with your favorite compiler on 
your favorite operating system. 



If you have done everything properly, you will see 
the following output on your shell window: 



$ ./a.exe 
Received file: 



filel.txt 



As you can see from the output, the function that we 
expected to work with a bar_documents namespace 
document object works properly. If we uncom- 
mented the line marked with 1, we would get a 
compile error, since that function does not expect to 
receive a document object from a different name- 
space. This is illustrated in Listing 17-4. 



When creating your own reusable classes in 
C++, always place them within a namespace 
to avoid name collisions with third-party 
libraries and other internally developed code. 




Listing 17-4: Trying to Use a Different Namespace Class 



ch3_5.cpp: In function 'int maintint, char**)': 

ch3_5 . cpp : 74 : error: no matching function for call to ' foo_wi ndowi ng :: document 

:: document ( const char[16])' 
ch3_5 . cpp : 28 : error: candidates are: foo_wi ndowi ng :: document :: document ( const 

foo_wi ndowi ng : :document&) 
ch3_5 . cpp : 39 : error: foo_wi ndowi ng :: document :: document ( i nt , 

const char*) 

ch3_5 . cpp : 34 : error: foo_wi ndowi ng :: document :: document ( ) 
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When you break a bone, the doctor puts it in a cast to make sure 
that the bone sets properly and keeps the correct shape. C++ 
has the same notion of casts — and they're used for exactly the 
same reasons. A cast in C++ explicitly changes a variable or value from 
one type to another. In this way, we "fix" things by making them the 
proper type for what we need those values for. 

The need for casts comes from the picky nature of the C++ compiler. If you 
tell it that you're expecting a given function to take an integer value, it will 
complain if it is given anything but an integer value. It might complain (for 
example) by warning you that there's a lack of precision, like this: 

i nt f unc ( i nt x ) ; 



long x=100; 
func(x) ; 



Here the compiler gripes about this function-call invocation, saying that 
converting a long integer to a regular one is legal, but you're risking a 
possible loss of precision. The compiler is right, too. Imagine, for exam- 
ple, that the value of x is 50,000 instead of 100. That number is too big to 
be stored in a normal integer, so it overflows and the function gets 
passed a negative number to chew on. Don't believe it? Try the following 
little programlet: 

^include <stdio.h> 

int func(short int x) 
{ 

printf ( "x = %d\n" , x ) ; 

} 



int maind'nt argc, char **argv) 

{ 

1 ong x = 10 ; 
f unc(x) ; 
x = 50000; 
func(x) ; 
return 0; 
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Here, because the gcc compiler assumes that i nt and 
a 1 ong integers are the same thing, we have to use a 
short jj± in the function itself for gcc to illustrate 
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short _ujt in the function 1 
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you compile and run this program, you see 
the following output: 

$ . /a . exe 

x = 10 

x = -15536 

Not exactly what we asked for, is it? 

If you know that the value of x is never going to 
exceed the maximum value of an integer, you can 
safely call the function even with along integer, as 
long as you cast it properly: 

func( (short int)x ) ; 

The reason that you might want to do something like 
this is that you don't want to create a new variable, 
assign the value to it, and then check to make sure 
that it did not overflow the range of that new variable 
type. The cast does all of this for you. 

Of course, encasing the integer in a cast is consider- 
ably more powerful than simply making an integer 
into alongoradoubleor anything else. Casting one 
type to another turns the original variable into a new 
one, albeit behind the scenes. This is true whether 
we are casting a variable in the example above, or 
modifying a variable by casting it to another type. 



If you eliminate all compiler warnings in an 
application, you can track down problems 
much more quickly and easily — you're letting 
the compiler do your work for you. Most 
compiler warnings, including those requiring 
casts, need to be addressed immediately, not 
just ignored. This will save you time in the 
long run. 



In the next section, I show you a more involved 
example of a cast. 




Suppose that you have two base classes, Basel and 
Base2. From these two classes, we derive a third 
class, called Deri ved. How can you get at functions 
in the base classes that have the same name in both 
bases? The answer lies in a cast, as we will see in 
this example technique. It might seem that we are 
back to the discussion of name differentiation and 
namespaces, but this is not the case here. Consider 
the following layout: 

Class 1: Method A 

Class 2: Method A 

Class 3: Derived from Class 1 and 2. 

When we are using Class 3, and refer to Method A, 
which method do we really mean? 

In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named c h 1 8 . c p p , 
although you can use whatever you choose. 

2. Type the code from Listing 18-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 18-1: Using Casts 

#include <stdio.h> 
^include <string> 

using namespace std; 

class Basel 
{ 

private: 

string _name; 

long _value; 
publ i c : 

Basel ( ) 



(continued) 
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Listing 18-1 (continued) 



Baseli const char *n, long v) 
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vi rtual "Basel ( ) 

stri ng GetName( ) 
return _name; 
ong GetVal ue( ) 
return _val ue ; 
void SetName( const char *sName ) 

_name = sName; 
void SetValue( long 1 ) 



class BaseZ 

{ 

private: 

stri ng _f i 1 eName ; 

long _fileLength; 
publ i c : 

Base2( ) 

{ 

_f i 1 eName = " " ; 
_fileLength = 0; 

I 

Base2( const char *n ) 

{ 

_fil eName = n; 
_fileLength = 0; 

} 

stri ng GetNamet ) 

{ 

return _fileName; 

I 

1 ong GetLength( ) 

{ 

return _fileLength; 



void SetName( const char *sName ) 

{ 

_fil eName = sName; 

} 

void SetFi 1 eLength ( long 1 ) 

{ 

_f i 1 eLength = 1 ; 



3. Save the source-code file. 

The code in this listing simply defines two 
classes that happen to share a common method 
name or two. This is not a problem, of course, 
because they are defined in different scopes — 
which means they can be reconciled by the com- 
piler and linker into different entries in the appli- 
cation. In other words, there's no problem. Now, 
let's create one. 

4, Reopen the source-code file with your code edi- 
tor and add the code from Listing 18-2 to the file. 

Listing 18-2: The Derived Class 

class Derived :public Basel, public Base2 
{ 

publ i c : 

Derived( void ) 

: Baseli "AClass", 10 ), 
Base2{ "Derived" ) 



Derived( const char *name) 
: Basel ( name , 0 ) , 
Base2( "Derived" ) 

{ 
} 

void ADeri vedMethod ( ) 

{ 

printfC'In a derived method\n"); 



S. Save the source-code file. 

This code illustrates a derived class that is built 
from two base classes. In this case, both of the 
base classes contain a method of the same name. 
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cm only be done 
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We need to find a way to get at the specific 
method in the base class that we want, which 
n only be done via casts. Let's look at that now. 



ie and link this program, it 
"aside from missing its main 
function. The compiler would not complain 
about the Base classes, nor the derived class. 
There is no problem with deriving a class from 
two base classes that happen to share a common 
method name. 

The problem comes in when we try to use a 
method from the base classes through the 
derived class. 

6. Append the code from Listing 18-3 to the file to 
implement a test driver for the code. 

Listing 18-3: The Derived Class Test Driver 

int mainO 

{ 

Derived d ; 

d.SetFi 1 eLength(lOO) ; 
d.SetNamet "This is a name" ); 
string s = d.GetNamet); 
return 0; 



ch3_8 . cpp : 34 : error: void 

Basel: :SetName(const char*) 
ch3_8 . cpp : 103 : error: request for member 

'GetName' is ambiguous 
ch3_8 . cpp : 60 : error: candidates are: 

std::string Base2 : : GetName( ) 
ch3_8 . cpp : 26 : error: 

std::string Basel :: GetName( ) 



Addressing the Compiler 
Problems 

Now we have an error — so (of course) the question 
is, how do you get at the Base-class methods when 
they conflict? Actually you have two ways to do this: 
Explicitly scope the member function that you want 
to use, or specifically cast the object so it has the 
type you want it to be. In this section, I show you 
how to perform both methods and discuss the con- 
sequences of each . 



f. Reopen the source-code file from the example 
(we called it chl8 . cpp) and append the code 
from Listing 18-5. 



Listing 18-5: The Modified Test Driver Code 

7. Save the source-code file and close the code int ma i n ( ) 

editor. ( 

Derived d; 

S. Compile the program using your favorite 

source-code compiler on your favorite operat- 
ing system. 

You should see output from the compiler resembling 
that of Listing 18-4: 



d.SetFileLength(lOO) ; 
/* 1 */ ( (Basel)d) . SetName( "This is a 
name" ) ; 

/* 2 */ string s = d . Basel :: GetName( ) ; 
return 0; 



Listing 18-4: Sample Output 

$ gcc ch3_8.cpp -lstdc++ 

ch3_8.cpp: In function 'int mainU': 

ch3_8 . cpp : 102 : error: request for member 

'SetName' is ambiguous 
ch3_8 . cpp : 68 : error: candidates are: void 

Base2 :: SetName( const char*) 



The two alternatives are labeled with comments, 
between the asterisks, as blocks 1 and 2. The line 
labeled 1 is the explicit cast; the line labeled 2 
is the scoped method call. You can probably see 
that the second method is somewhat more read- 
able, but both will work just fine. The difference 
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between them, really, is how the lines are inter- 
preted by the compiler. When you cast an object, 

are, as far as the compiler is concerned, 
ll£^ll^l|mtel | £'jJ«type. When you call the 
la^j^Jhle^JaV^J the cast of the object, 
the SetName method is being called with a Basel 
object, rather than a Deri ved object. What does 
this mean? 

Modifying the classes a bit provides a handy 
illustration, starting with the next step. 

2. Replace the original definitions of Basel and 
Base2 with the following code, shown in Listing 
18-6. 



Listing 18-6: The New Base Class Listings 

class Basel 

{ 

pri vate : 

string _name; 
long _value; 

virtual void Pri ntNameChange( ) 

pri ntf( "Changed name to %s\n", 
_name.c_str( ) ) ; 



publ 



l c : 

BaseK ) 



BaseK const char *n, long v) 

_name = n; 
_val ue = v ; 

vi rtual -Basel ( ) 



stri ng GetName( ) 

return _name; 
ong GetVal ue( ) 

return _val ue ; 
void SetName( const char *sName ) 



_name = sName; 
Pri ntNameChange( ) ; 

} 

void SetValue( long 1 ) 

{ 

_val ue = 1 ; 

( 

} ; 

class Derived :public Basel, public Base2 
1 

virtual void Pri ntNameChange( ) 
1 

pri ntf ( " Deri ved : Pri ntNameChange 
cal 1 ed\n" ) ; 

} 

publ i c : 

Derived( void ) 

: BaseK "AClass", 10 ), 
Base2( "Derived" ) 



Derived( const char *name) 
: BaseK name , 0 ) , 
Base2( "Derived" ) 



void ADeri vedMethod ( ) 

{ 

printfC'In a derived method\n"): 



Testing the Changes 

After you've made all the changes in the Base classes 
for the objects you're using, the wise next step is to 
test those changes to make sure the compiler is 
happy and the code works properly. Here's the drill: 

f m In the code editor of your choice, reopen the 
existing file to hold the code for your test 
program. 

In this example, I named the test program 

chl8 . cpp. 

2. Type the following code into your file as shown 
in Listing 18-7. 
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Better yet, copy the code from the source file on 
this book's companion Web site. 
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int mainT) 

[ 

Derived d ; 

d.SetFileLength(lOO) ; 

(( Basel )d ). SetName( "This is a name" ); -* 1 

string s = d . Basel :: GetNamet ) ; 

d . Basel :: SetNamet "Thi s is another name"); 

return 0; 



3. Save the source file in the code editor and 
close the editor application. 

4. Compile and link the application on your 
favorite operating system, using your compiler 
of choice. 

If you have done everything right, you should see 
the following output appear on your shell window. 

$ . /a . exe 

Changed name to This is a name 

Derived: Pri ntNameChange called -* 2 

If you trace through the code, you will see what is 
going on here: 



In the first case, where we physically cast the d 
object (shown at -* 1) to a Basel object, the object 
does not "know" that it is really a Deri ved object 
when the virtual method Pri ntNameChange is called. 
As a result, the Base class method is used for the 
cast case (shown at -+ 2). 

For the second case, where we scoped the method, 
however, the object is well aware of what it is, and 
will call the inherited virtual method in the Deri ved 
class. This is a very important difference, and can 
lead to some very subtle logic errors in your pro- 
gram that are very hard to track down and fix. Casts 
are a very powerful technique in C++, but they are 
also a serious warning that you are doing something 
you are not supposed to be doing. If your actions 
were acceptable in the language, you would not have 
to explicitly tell the compiler that you are changing 
the behavior of the code through a cast. This is not a 
bad thing, but you need to be aware that you are 
changing behavior. Be sure to understand the side 
effects of your actions and the possibilities of intro- 
ducing more problems than you are solving when 
you use a cast. 



Whenever possible, avoid putting casts in your 
application. If this is not completely possible, 
understand fully the warnings that your com- 
piler issues for casts you've made. 
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Pointers to member functions are incredibly powerful — and an 
integral part of the C++ language. If you use them, your code will be 
easier to understand and expand, and maintenance will be much 
quicker. In addition, new functionality can be added without having to 
modify the existing functions in the class. Pointers to member functions 
help replace complicated switch statements, lookup tables, and a variety 
of other complicated constructs with a simple, easy-to-implement solution. 

However, because they are confusing to implement and syntactically 
complicated, almost nobody is willing to use the poor things. Nonetheless, 
the pointer to a member function is a really useful tool in your arsenal of 
techniques for solving problems with the C++ programming language. 
The issue, really, is understanding how they work and how to make the 
compiler understand what you want to do with them. 

The first thing to understand is, what exactly is a pointer to a member 
function? In the good old days of C programming, we had plain old function 
pointers. A function pointer was a pointer to a global function, whereas a 
pointer to a member function works only with a class member function; 
they are otherwise the same thing. Essentially, function pointers allowed 
you to do this: 

typedef int (*error_handl er) (char *); 

This statement defined a pointer to a function that accepted a single 
argument of the character pointer type, and returned an integer value. 
You could then assign a function to this pointer, like this: 

int my_error_handl ertchar *s) 

{ 

pri ntf( " Error : %s\n", s ); 

return 0; 

} 

error_handl er TheErrorHandl er = my_error_handl er ; 



In a library (for example), this is a very useful way to handle errors. You 
allow each user to set his or her own error handler, rather than simply 
printing them out, or popping up an error dialog box, or logging the 
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pesky things to a file. This way the end users of the 
library could trap errors and deal with them — by 
changu^J the description, printing out additional 
/"^4B!fcAiii| jfflto|fTltollflffi^J whatever else worked 

Within your library code, you would then invoke the 
error handler by writing: 

(*TheErrorHandler)(theErrorString); 

obviously checking to see iftheTheErrorHandler 
was actually assigned to anything first, or was 
instead NULL. 

That was how function pointers were used in C. 
When C++ arrived, this same kind of functionality 
was very useful for a variety of tasks and continued 
to work fine with global functions. However, there 
was no simple way to implement this functionality 
since a member function required an object to oper- 
ate on it, so you couldn't just assign it to a random 
pointer. You can store a member function pointer 
anywhere. When it comes to using it, however, you 
need an object of the class of that member to use it. 
For example: 

class Foo 
{ 

// A member function 
voi d bar( i nt x ) ; 
// This defines a type 
typedef void (*ptr_to_member_f uncti on ) 
( i nt x) ; 



With the advent of member-function pointers, you 
could assign a member function to a random pointer, 
if you didn't mind a bit of strange syntax. You can 
define these pointers as 

typedef <return-type> ( <c lassndme> : : * 
PtrMemberFunc) ( <args>) ; 

Implementing Member-Function 
Pointers 

Let's take a look at a technique for using member- 
function pointers to implement a simple command 
processor. 

In the code editor of your choice, create a new 
file to hold the source code for this technique. 

In this example, I named the test program 

chl9 . cpp. 

2. Type the code from Listing 19-1 into your file. 

Or better yet, copy the code from the source file 
on this book's companion Web site. 

Listing 19-1: Pointers to Member Functions 

^include <stdio.h> 
^include <string> 
#include <vector> 

class Processor 



publ i c : 

ptr_to_member_f uncti on pi; 

Foo () 

{ 

// Assign the member function pointer 
pi = bar; 



! 



) 



typedef bool 

(Processor: : *PtrMemberFunc ) ( std: :string 

) ; -> 1 

private: 

std::vector< PtrMemberFunc > 

_f uncti onLi st ; 
protected : 

virtual bool ProcessHel I o( std : : stri ng s) 



/ / Later i n the code .... 

Foo::pl(0); // This won't work, since the 
member function requires a 
poi nter . 

Foo x ; 

x.pl(O); // This will work. 



if ( s == "Hello" ) 
{ 

pri ntf ( "Wei I , hello to you 
too! \n" ) ; 
return true; 

(continued) 
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l_ ^ ^ return jfalse; 
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essGoodbyet std : : 



string s ) 



if ( s == "Goodbye" ) 

{ 

pri ntf( "Goodbye . Have a great 
day ! \n" ) ; 
return true; 

} 

return false; 

} 

virtual bool ProcessOpen( std::string s) 

{ 

if ( s == "Open" ) 

{ 

printfC'The door is now open\n"); 
return true; 

} 

return false; 



publ i c : 

Processor( ) 

{ 

_functionList.insert( 
_functionList.end( ) , 

&Processor: : ProcessHel 1 o ); 

_functionList.insert( 
_functionList.end( ) , 

&Processor: : ProcessGoodbye ): 
_functionList.insert( 
_functionList.end( ) , 

&Processor: : ProcessOpen ); 
} 

virtual ~Processor() 



void ProcessCommand ( const std::string& 
command ) 

{ 

std::vector< PtrMemberFunc >::itera- 
tor iter; 

for ( iter = _f uncti onLi st . begi n ( ) ; 
iter ! = 

_f uncti onLi st . end () ; ++iter ) 



PtrMemberFunc ptr = (*iter); 
if ( (thi s->*ptr) ( command ) ) 
return ; 

} 

pri ntf( "Unknown command %s\n", 
command . c_str( ) ) ; 



3, Save your source code in the editor. 

Notice that after you've defined a member-function 
pointer (see -* 1) , you can use it the same way you'd 
use a "normal" pointer. In this particular case, we 
build up an array of pointers and simply chain 
through them to see whether a given string is 
processed. Code like this could be easily used for 
equation parsers, command processors, or anything 
else that requires a list of items to be validated and 
parsed. Listing 19-1 is certainly a lot cleaner and eas- 
ier to extend than code like the following: 

switch ( command ) 
{ 

case "Hello": 

// Do something 

break; 
// . . other cases 
def aul t : 

pri ntf ( " Inval i d command: %s\n", 

command . c_str ( ) ) ; 

break 

} 

Note that in this case, we need to add a new switch 
case each time we want to handle a new command. 
With our array of function pointers, after it is defined 
and added to the code, the member function does all 
the work. 
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Processor2( ) 

{ 

} 



"only is Listing T9-T cleaner and easier to extend, 
it is also vastly easier to expand, because you can 
override whatever functionality you want at the 
member-function level. 

The distinction is worth a closer look, to show you 
just how useful this technique can be in your appli- 
cation. Imagine that you've implemented this 
Processor obj ect and are merrily using it to process 
input from the user. Now, suddenly, someone else 
wants to use the same class — but they want to 
implement a completely different use for the Open 
command. All the other commands work the same 
way. Wouldn't it be nice to utilize the same class to 
do the work — and only override the function that 
you wanted to change? It turns out that you can. 
Remember, a pointer to a member function is simply 
a pointer to whatever will be called when that partic- 
ular method is invoked on the object. If we override 
a virtual method in a derived class, it should auto- 
matically call that method when we use our new 
processor. The following steps try that: 

f m Append the code from Listing 19-2 to your 
source-code file. 



2, Save your source code in the editor and close 
the code-editor application. 



lestinq the Member Pointer Code 

After you create a pointer to a member for a class, 
you should create a test driver that not only ensures 
that your code is correct, but also shows people 
how to use your code. 

Here's the classic follow-up — creating a test driver 
that shows how the class is intended to be used: 

f m In the code editor of your choice, open the exist- 
ing file to hold the code for your test program. 

In this example, I named the test program 

chl9 . cpp. 

2. Type the code from Listing 19-3 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 19-2: The Command Processor Class 

class Processor2 : public Processor 

{ 

protected : 

virtual bool ProcessOpent std::string s) 

{ 

if ( s == "Open" ) 
{ 

pri ntf ( "Deri ved processing of 
Open\n" ) ; 
return true; 

} 

return false; 

} 

publ i c : 



Listing 19-3: The Test Driver for the Command Processor 

int maintint argc, char **argv ) 
{ 

Processor2 p; 

for ( int i=l; i<argc; ++i ) 

p . ProcessCommand ( argv[i] ); 

} 



3. Close your source-code file in the editor and 
close the editor application. 
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4, Compile the source code with your favorite 
compiler on your favorite operating system, 
•— ^ iuuL then run k with the following command: 

Uropo€)Oks 

If you have done everything right, you should 
see the following output when you run the pro- 
gram with these arguments. 



Derived processing of Open 
Goodbye. Have a great day 

As you can see, not only have we created a com- 
mand handler to process the open command, but we 
have also allowed for standard C++ derivation. In 
addition, we could easily add additional handlers 
that process the same command, something that we 
could not do with the swi tch statement. 
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In C++, a failure to call functions or methods properly is a common 
problem. One solution is to verify all input values when the end user 
sends them in — but this has the unhappy side effect of creating more 
errors for the end developer to fix. The problem is that it is harder to 
screen out bad values than it is to accept only good ones. For an integer 
value that is supposed to be between 1 and 10, for example, there are ten 
valid values. However, there are an infinite number of bad integer values 
that exist outside the range of 1 to 10. Wouldn't it be nice if you could tell 
the developer what the most likely value is for some of the less-common 
function arguments? The programmer could then ignore the problematic 
values by using acceptable defaults. For example, consider the 
MessageBox function, a standard function used by many Microsoft 
Windows programmers. This function, which has the following signature, 
displays a message for the application user to see and respond to. 

int MessageBox( 
HWND hWnd, 
LPCTSTR IpText, 
LPCTSTR IpCaption, 
UINT uType 

); 



The MessageBox arguments are as follows: 



*>* h Wnd: A handle to a Windows window 

v 0 IpText: The text to display in the message box 

W IpCaption: The caption to put in the title bar of the message box 

<>* uType: The types of buttons (OK, Cancel, Abort, Retry, and so on) to 
display in the message box. 

This is a very handy function and is used nearly universally by Windows 
programmers to display errors, warnings, and messages. The problem 
is that it's too easy to forget the order of the arguments. In addition, pro- 
grammers tend to use the thing over and over in the same ways. This 
means that the same code is repeated over and over, and changes must 
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be made all over the system when a new way of 
doing things is desired. It would be nice, therefore, to 
be ablejQ.customize this MessageBox function with 



Listing 20-1: A Customized MessageBox Function 




]|f5\s/PV<L^bi 



Sjust call it the way we 
s 



specify only the values 
that change, which limits the number of arguments to 
enter, making it easier to remember the order and 
easier to avoid error values. 

Customizing a function can mean one of two things: If 
we are the ones writing the function, it means that we 
can customize the kind of arguments that go into the 
function and how those arguments are likely to be 
used. If we didn't write the function in the first place, 
we can't do those things; we can only "change" the 
way the function is called by wrapping something 
about it — that is, placing it inside a new function we 
created ourselves — one that plays by our rules. 
We'll look at the first case in a bit; for right now, con- 
sider the case of wrapping something around our 
poor MessageBox function to make it easier for the 
application developer to use. 

Customizing the Functions 
We Didn't Write 

One probable use of the MessageBox function is to 
display error messages. Because the end user can do 
nothing with such an error, there is no reason to 
display the Cancel button on the message box — even 
though most applications do just that. In this section, 
I show you how to create your own variation on 
the MessageBox function — the ErrorBox function — 
which is different from MessageBox only in that it puts 
the word "Error" at the top of the display title bar and 
it displays only an OK button with the text. There's no 
real reason to create any new functionality for this 
function, because, after all, the MessageBox function 
already does everything we want it to do. Our func- 
tion would look like Listing 20-1. 



int ErrorBox( 
const char 
MB OK ) 



HWN D hWnd, const char *text, 
Hitle = "Error", UINT type 



MessageBox( hWnd , text, title, type ); 



Okay, we aren't adding much value here, but consider 
how the function is now called within an application 
code: 

// Display an error 

ErrorBoxt NULL, "You have to first enter a 
f i 1 e name ! " ) ; 

This is certainly a lot easier than the full-blown 
MessageBox call. The advantage, of course, is that 
you don't have to use the shortened version — you 
can still use the entire thing, like this: 

ErrorBox(m_hWnd , "The system is very low 
on memory! Retry or Cancel?" "Critical 
Error", MB_RETRY | MB_CANCEL ); 

The shortened version is certainly more readable 
and consistent, and it saves you time because it 
offers fewer parameters to update. What if, for exam- 
ple, management decides that the phrasing of your 
error is too harsh and wants to replace it with A 
problem has occurred? If you're using the long ver- 
sion of this function, the way to solve this problem is 
to find all calls to the function in your code. With our 
wrapper function, however, we could eliminate the 
error in the call itself, and place it into the wrapper 
function. All errors, for example, could begin with 
"An error has occurred" and then append the actual 
error text. Of course, to make things even easier, you 
could go a step further and allow the function to 
read data strings from an external file — that capa- 
bility would allow for internationalization as well. 
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0| course, simplycustomizing other people's code 
isn't always the best approach when adding default 
arguments. Default arguments are arguments that the 
function developer provides. If you do not want to 
specify a value other than the default, you omit the 
argument entirely. If you wish to change the default 
for a specific invocation, you may do so. The real 
point to the practice is to provide the most likely uses 
of a given argument, while protecting the capability of 
the user to change (or customize) your defaults. 

This technique creates, in a single class, both the 
functions and methods that allow the user complete 
control over his or her input — while providing 



appropriate defaults that make it simple to use the 
class's methods and functions to accomplish normal 
operations. 

An example is an operation that most programmers do 
on a regular basis: creating a file. The following steps 
show you how to create a very simple File class that 
allows opening, reading, writing, and closing files: 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch20 . cpp, 
although you can use whatever you choose. 

2, Type the code from Listing 20-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 20-2: A Class with Methods Containing Default Values 



#include <stdio.h> 
#include <string> 

class FileHandler 
{ 

private: 

std::string m_fileName; 
FILE *m_fp; 

static const char *fileName() 
{ 

return "log.txt"; 



publ i c : 

FileHandlert const char *fn = NULL ) 
{ 

if ( fn ) 

m_fileName = fn; 

else 

m_fileName = fileNameO; 



(continued) 
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Listing 20-2 (continued) 

int open( const char *name = fileNameO, const char *mode = "rw" ) 1 




int open( const std : : stri ng& mode ) -* 2 

{ 

m_fp = fopen( m_f i 1 eName . c_str( ) , mode.c_str() ); 
if ( m_fp == NULL ) 

return -1; 
return 0; 

} 



3, Save your file. 

In the constructor, we set the default filename as a 
NULL pointer. If the user overrides the filename, we 
use the name they ask for. Otherwise we simply use 
the internal name returned by the f i 1 eName method 
in our class. 

For the first open method (-» 1), we also allow users 
to override the filename — but this time we directly 
initialize the filename from the internal method 
(f i 1 eName( )). This default value allows the user to 
call the first open function with no arguments, if they 
choose. 

Working with regular (non-static) methods 

Note that this way of calling a method as a default value 
works only if the method in question is static. You can't do 
this with a regular method, because regular methods require 
an object — and this way of calling puts you outside the 
scope of the object you're using. 

For example, we can't do something like the following: 

virtual const char *filename() 
{ 

return "log.txt"; 

I 



and then use it this way: 

int open( const char *name = fileNameO, 
const char *mode) 

The compiler will get annoyed, because the fil eName 
method requires a this pointer to operate on. The level at 
which we're working has no thi s pointer. Worse, you can't 
write a command like this one: 

int open( const char *name = thi s - > 
filename, const char *mode ) 

The reason you can't is simple: The this pointer makes no 
sense in this case. You aren't inside an object, so you can't 
tell the outside world to refer to the object you are in. It's an 
annoyance, but it's one of those things you just get used to. 
If you find this too much trouble, use the same technique 
the constructor uses to call the method. 

Finally, we have the second open method that can 
open the file — specifying only the mode we wish. 
Notice that we can't default this method. Why? If the 
method had a default argument, there would be no 
way to tell whether the user meant to call the first or 
second version of the open method. To illustrate, 
consider the following series of calls in an applica- 
tion program: 

FileHandler fh; // Invokes the constructor 
f h . open ( ) ; 



Testing the Default Code 



Now, if we had given the second variant 2) of the 
open method a default argument, which version of 
the opaiujiethod would be called ? It could be 



the opaujietnod would t>e 
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or it could be 

fh.open(mode) ; 

The compiler has no way of knowing which method 
the developer originally intended, so it doesn't allow 
the use of this technique at compile-time. 

Of course, we need to add a method to write to the 
file. There's no way to rationally default the values 
we want to write out — that's entirely up to the end 
user of the class — so we won't lift a finger to do so. 
For a wri te statement, how could you have any idea 
what data the end user wanted to write? You couldn't, 
nor is there any sort of pattern to it. 

In your code editor, insert the code shown in Listing 
20-3 to your program's source code. (It goes before 
the closing brace of the class's public part.) 

Listing 20-3: The File Write Method 



bool writet 


const char 


*string ) 


{ 

bool bF 


let = false; 




if ( m_ 


fp ) 




fputst string, 


m_f p ) ; 



bRet = true; 

} 

return bRet; 



Testing the Default Code 

It's a good idea to test the class with both default 
and non-default values, just to see whether your 
assumptions are valid. 



The following steps show you how to create a test 
driver that will show how the class is intended to 
be used: 

f m In the code editor of your choice, open the 
existing file to hold the code for your test 
program. 

In this example, I named the test program 

ch20 . cpp. 

2. Type the code from Listing 20-4 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 20-4: The Test Driver for the FileHandler Class 

int maind'nt argc, char **argv) 
{ 

FileHandler fh; -» 

if ( fh.openO == -1 ) 

pri ntf ( "Unabl e to open file. Errno 
%d\n " , errno ) ; 

f h .wri te( "Thi s is a test"); 

FileHandler fh2Clog2.txt") ; -» 
f h . open ( "w" ) ; 

f h .wri te( "Thi s is another test"); 



3, Save the source code and close the source-code 
editor. 

4, Compile the code using your favorite compiler 
on your favorite operating system. 

If you have done everything right, the program 
should create the 1 og . txt and 1 og2 . txt files. 
These files should be created at -> 3 and -* 4 in 
the driver code. The files will contain our output 
for the FileHandler objects. However, you will 
quickly find that it did not, in fact, create any 
files. Depending on your operating system and 
compiler, you may even get a program crash. So 
what went wrong? 



we 
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Fixing the Problem 



; statements in the open 
Its, you can find the prob- 
lem very quickly: The open method is called recur- 
sively, until the stack is exhausted and the program 
crashes. Why? Because of the nature of our default 
arguments, the open function with default arguments 
calls open again within itself after having assigned 
the arguments. The best match for the open call in 
our open method happens to be the method itself! 
This causes an endlessly recursive loop. So, of 
course, bad things happen when you call yourself 
repeatedly in a method. Let's fix that by modifying 
the open method as in Listing 20-5 (replace the exist- 
ing method with the new listing code): 



Listing 20-5: The Modified open Method 

int open( const char *name = 
f i 1 eNamet ), const char *mode = "rw+" 
{ 

m_fileName = name; 
std : : stri ng s = mode ; 
return open ( s ) ; 



Now, if you compile and run the program, you'll find 
that it runs properly and generates the two files as 
expected. 
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When you are trying to use or reuse a class in C++, there is nothing 
quite so frustrating as finding that the method that you need is 
not implemented in that class, or that the method does not work 
properly when you try to use it in the environment you are using. The rea- 
son for this is usually that the programmer who developed the class did 
not create a Compl ete class — but what, exactly, does it mean to create 
one? That's a good question, and this technique will try to answer it. 

To do its job, a Compl ete class must follow a list of specific rules. These 
rules, in their correct order, are as follows: 



f m The class must implement a void constructor. 

2. The class must implement a copy constructor. 

3. The class must implement a virtual destructor. 

4. The class must implement a get method for each data element defined 
in the class. 

5. The class must implement a set method for each data element defined 
in the class. 

6. The class must implement a cl one method so it can make a copy of 
itself. 

71 The class must implement an assignment operator. 



If you create a class that follows all these rules, you have likely created a 
Compl ete class, one that will be reused by programmers over and over 
again. This will save you time and effort in not having to reinvent the 
wheel each time that type of code needs to be used in a project. 



Please note that having a set method for a class implies strongly that 
( iHO ) tne set met ' 10C ' w '" check f° r invalid values. Also, if you have pointers 
in your class, you should make sure that you initialize them to NULL, 
copy them properly, and destroy them when they are done. A set 
method for a pointer ought to take into account that it is acceptable 
to set the pointer to NULL and not have any memory leaks. 
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Creating a Complete Class 
Template ■ 

DDpOOkS 

ThpTolTowing steps show you an example of a 
Compl ete class that you can use as a template for all 
the classes you implement in the future. 



If you create a template for creating objects and 
a process for implementing that template for 
new classes, you avoid many of the problems 
that haunt C++ programmers. Because the pur- 
pose of these techniques is to not only improve 
your coding skills, but also to insure that you 
create better software, this is a very valuable 




technique that you should insist all developers 
on your team use in all of their application code. 
There are no classes that are "too trivial" to ben- 
efit from these enhancements. 

f m In the code editor of your choice, open the 
existing file to hold the code for your test 
program. 

In this example, I named the test program 
ch21 . cpp. 

2. Type the code from Listing 21-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 21-1: The Complete Class 



//include <stdio.h> 
//include <string> 
//include <string.h> 

class Complete 

{ 

pri vate : 

bool dirty; // Keep track of the object state, 

private: 
i n t x ; 
doubl e y ; 
std : : stri ng s ; 
char *p ; 

// Create an initialization function that 
// can reset all values, 
void I n i t ( ) 

( 

x = 0; 
y = 0; 
s = " " ; 
if ( p ) 

delete p; 
p = NULL; 
di rty = fal se ; 



// Create a copy function that you can use to make 

// clones of an object. 

void Copy( const Completes aCopy ) 



Init( ) ; 



Creating a Complete Class Template 



x = aCopy.x; 
y = aCopy.y; 
s = aCopy.s; 

DropBoms 

if ( aCopy.p ) 

{ 

p = new chart strl en ( aCopy . p ) ]; 
strcpy ( p , aCopy . p ) ; 

I 

di rty = true ; 

) 

publ i c : 

// Always create a default constructor. 
Compl ete( ) 

{ 

// We need to set the pointer first, 
p = NULL; 

// Now initialize. 
Init( ) ; 

I 

// Always create a copy constructor. 
Complete( const Completes aCopy ) 

// We need to set the pointer first, 
p = NULL; 

// Now copy the object. 
Copy ( aCopy ) ; 

I 

// Always create a full constructor with all accessible 
// members defined. 

Complete( int _x, double _y , std::string& _s , const char *_p ) 
{ 

x = _x ; 

y = _y; 

s = _s ; 
if ( _p ) 

{ 

p = new char[ strlen(_p) ]; 
strcpy ( p , _p ) ; 

I 

el se 

p = NULL; 
di rty = true ; 

I 

// Always create a virtual destructor, 
vi rtual -Compl ete( ) 

{ 

if ( p ) 

delete p; 

(continued) 
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Listing 21-1 (continued) 




ine accessors for all data that can be public. If 
ded to be public, make it a private accessor. 
s^^deHaliflF al 1 the set methods, fhe "dirty" flag is not 
// necessary for completeness, but it makes life a LOf easier. 



void setX(const int& _x) 
{ 

if ( x != _x ) 
di rty = true ; 



x = _x ; 

} 

void setY(const doubles _y) 

{ 

if ( y !- _y ) 
di rty = true ; 

y = _y: 

I 

// Note that for strings, we always use the easiest base type, 
void setS(const char *_s ) 

{ 

if ( s != _s ) 

di rty = true ; 
s = _s ; 

} 

void setP( const char *_p) 

{ 

if ( p != _p ) 
di rty = true ; 

// Always clear out a pointer before setting it. 
if ( p ) 

{ 

delete p; 
p = NULL; 

} 

if ( _p ) 

{ 

p = new char [ strlen(_p) ]; 
strcpy ( p , _p ) ; 

I 

el se 

p = NULL; 

} 

// Now the data get functions. Note that since they cannot modify 
// the object, they are all marked as const. 
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return x; 
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int getX(void) const 
{ 

return x; 

const 
return y; 

} 

std::string getS(void) const 
{ 

return s; 

} 

// Note: For internal pointers, always return a CONST pointer. 

const char * getP(void) const 

{ 

return p; 



// Implement a clone operator. 

Complete Clone(void) 

{ 

Complete c; 
c.Copyt *this ); 
return c; 



// Implement an assignment operator. 
Complete operator=( const Completes aCopy ) 



Copy( aCopy ); 
return *this; 



) ; 



3, Save the source file. 

When you are creating your own classes, you 
as- («a) should seriously consider using Listing 21-1 as 
VAV a template. If all classes implemented all their 

functionality in this manner, they would easily 

rid the programming world of 10 to 20 percent 

of all bugs. 

Testing the Complete Class 

Just writing the class is not enough. You also need to 
test it. Test cases provide two different uses for 



developers. First, they provide a way to make sure 
that you didn't make the code work improperly 
when you made the change. Secondly, and more 
importantly, they act as a tutorial for the user of 
your class. By running your test driver and looking 
at the order in which you do things, the programmer 
can discover how to use the code in his or her own 
program as well as what values are expected and 
which are error values. It is almost, but not quite, 
self-documenting code. 

How do you go about writing tests for your classes? 
Well, first you test all the "normal" conditions. One 
quick way to illustrate is to create a test driver that 
tests the constructors for the class, like this: 
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1, In the code editor of your choice, reopen 
the existing file to hold the code for your test 



S. Run the application. You should see the output 
from Listing 21-3 appear in the console window. 
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ch21 . CDD. 



ed the test program 

ch21 . cpp. 

2, Type the code from Listing 21-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 21-2: The Complete Class Test Driver 

void DumpCompl ete( const Completes anObj ) 

{ 

pri ntf ( "Object : \n" ) ; 
printfC'X : %d\n", anObj.getXO ); 
printfC'Y : %lf\n", anObj . getY ( ) ); 
printfC'S : %s\n", anObj . getS( ) . c_str( ) ); 
printfC'P : %s\n", anObj.getPO ? 
anObj.getPO : "NULL" ); 

} 

int main( ) 

// Test the void constructor. 
Complete cl; 

// Test the full constructor. 

std::string s = "Three"; 

Complete c2(l, 2.0, s, "This is a test"); 

// Test the copy constructor. 

Compl ete c3( c2 ) ; 

// Test the = operator. 

Complete c4=cl; 



DumpCompl ete( cl ) 

DumpCompl ete( c2 ) 

DumpCompl ete( c2 ) 

DumpCompl ete( c4 ) 



3, Save the source-code file in your editor and 
close the code-editor application. 

4. Compile the application, using your favorite 
compiler on your favorite operating system. 



Listing 21-3: Output 


$ . / a . GXG 




n h i o r t • 
U D J c L L . 




Y • n 

A . U 




v • n nnnnnn 

c . 




P : NULL 




Object : 




X : 1 




Y : 2.000000 




S : Three 




P : This is a test 




Object : 




X : 1 




Y : 2.000000 




S : Three 




P : This is a test 




Object : 




X : 0 




Y : 0.000000 
S : 




P : NULL 




As you can see, we get the expected output. The ini- 
tialized values default to what we set them to in the 
various constructors and copy functions. It's very 
hard to overestimate the importance of having unit 



tests like these. With unit tests, you have a built-in 
way to verify changes; you have ways to start testing 
your software; and you have documentation built 
right in the code. Unit testing is an important por- 
tion of such development methodologies as eXtreme 
Programming (now often called Agile Programming) 
and the like. 

Another important thing to note in our code is the 
di rty flag (shown at -> 1 in Listing 21-1) that we 
have built into the code. The simple di rty flag could 
easily be extracted out into its own small class to 
manage di rty objects — and can be reused across 
many different classes, as shown in Listing 21-4. 



Testing the Complete Class 



Listing 21-4: A ChangeManagement Class 

class ChangeManagement 
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publ i c : 

ChangeManagement (void) 

{ 

dirty = false; 

} 

ChangeManagement ( bool flag ) 

{ 

setDi rty (flag); 

} 

ChangeManagement ( const ChangeManagement? 
aCopy ) 

{ 

setDi rty ( a Copy . i sDi rty ( ) ) ; 

} 

virtual -ChangeManagement ( ) 

{ 

} 

void setDirtyt bool flag ) 

{ 

dirty = flag; 

} 

bool i sDi rty ( voi d ) 

{ 

return dirty; 

} 

ChangeManagement& operator=( const 
ChangeManagement& aCopy) 



Okay, why might we want to create a di rty flag? 
Well, for one reason, we could then manage the "dirt- 
iness" of objects outside the objects themselves. We 
might, for example, have a manager that the 
ChangeManagement class "talked to" to notify it when 
given objects become dirty or clean (and therefore 
have to be written to and from disk). This sort of 
thing would be very useful for a cache manager 
of objects, when memory is at a premium but disk or 
other storage space is available. 



Of course, writing unit tests doesn't mean that 
you have done a complete test. At this point, 
you've simply validated that the code does 
what you expected it to do when valid input 
was given. Never confuse testing with valida- 
tion. Validation shows that the code does what 
it is supposed to do when you do everything 
right. Testing shows that the code does what it 
is supposed to do when you do something 
wrong. 




setDirtyt aCopy . i sDi rty ( ) ); 
return *this; 
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It's no accident that this book devotes some time to understanding 
how classes are constructed — and how you can inherit from them. 
Inheritance allows you to save time and effort by providing a ready 
base of code that can be reused in your own classes. When you are doing 
class design, however, there are some problems that will cause you pain 
and consternation. One such problem is in multiple inheritance. While 
multiple inheritance can solve many problems in class design, it can also 
cause problems. For example, consider the case of Listing 22-1: 

Listing 22-1: A Multiple Inheritance Example 

class Base 
{ 

char *name; 
publ i c : 

virtual const char *Name(); 
void setName( const char *n ); 

) 

class A : public Base 

{ 

I 

class B : publ i c Base 

{ 

I 

class C : public A, public B 



Listing 22-1 shows a problem with multiple inheritance that you might 
not think could ever happen — but it happens nearly all the time. 
When we have a base class from which all classes in the system inherit 
information — such as an Object class that stores the name (that is, the 
type) of the class — we run into the problem of inheriting from the same 
base class in multiple ways. This situation is often referred to as the 
"deadly triangle" of object-oriented programming. If you instantiate an 
object of type C, as in the code shown in Listing 22-1, the compiler and 
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linker won't object — everything appears to work 
fine. However, the problem comes in when we try to 
use thfijaethods in.the base class Base. If we write 

|Name( ) ; 



use th&jjaethods m the bas 
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then the compiler immediately throws a fit, generat- 
ing an error for the source-code line. The reason 
should be obvious: Which name method are we calling 
here? There are two Base classes in the inheritance 
tree for class C. Is it the one in the base class A, or the 
one in the base class B? Neither is obvious, although 
we can scope the answer with a little effort: 



const char *name 



: Name( ) : 



This will fix our compile problem, because the com- 
piler now knows that we mean the Name method that 
is inherited through the class B tree. 

Unfortunately, this doesn't really solve the problem. 
After all, our C class is not a B, nor is it an A — it is a 
C, and only that. You might think a dodge like this 
could "fix" the problem: 

class C : public A, public B 



publ i c : 

CO 

I 

! 



3ase( "C" ) 



Here we explicitly tell the compiler that this is a C 
object and should be used as one. Because the base 
class constructor takes a name, and that name is 
used in the Name method, it ought to therefore assign 
the value C to the name. The problem is, if you try 
to compile this mess, you get the error shown in 
Listing 22-2: 

Curses, foiled again; this doesn't solve the problem 
at all. The compiler is complaining because it does 
not see which base class we are trying to use. Is it 
the base class of A, or the base class of B? This isn't 
clear, and therefore we cannot simply call the base 
class constructor. 

How, then, can we inherit from two base classes that 
(in turn) inherit from a common base class? The 
answer lies in a C++ concept known as virtual inheri- 
tance. Virtual inheritance combines multiple base 
classes into a single base class within the inheri- 
tance tree, so that there is never any ambiguity. 

In Listing 22-1, with two classes inheriting from a 
common base, the problem occurs because the base 
class occurs in the inheritance tree twice. Virtual 
inheritance forces the compiler to create only a sin- 
gle instance of the base class — and to use the data 
in that single instance wherever the data was last 
set. This means that the code literally skips the 
instantiation of the base classes in the two bases 
(A and B, in our example) and uses only the instantia- 
tion in the last class level, C. 



Listing 22-2: Compiler Output for Multiple Inheritance Error 



ch3_ll.cpp: In constructor 'C::CU': 

ch3_ll . cpp : 65 : error: 'Object' is an ambiguous base of 'C 

ch3_ll . cpp : 65 : error: type 'class Object' is not a direct base of 'C 

ch3_ll.cpp: In member function 'void C: : Di spl ay( ) ' : 

ch3_ll . cpp : 70 : error: request for member 'Name' is ambiguous in multiple 

inheritance lattice 

ch3_ll . cpp : 23 : error: candidates are: virtual const char* Object :: Name( ) 

ch3_ll . cpp : 23 : error: virtual const char* Object :: Name( ) 
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Implementing Virtuat Inheritance 



ritance in your base 
fe an inheritance structure 
thlt will permit all other classes that inherit from 
your base classes to work properly. The following 
steps take a look at how we can create an inheri- 
tance structure that implements virtual inheritance: 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch22 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 22-3 into your file. 

Or better yet, copy the code from the source file 
on this book's companion Web site. 

Listing 22-3: Base-Class Inheritance 

#include <stdio.h> 
#include <string> 

class Object 

{ 

pri vate : 

char *name; 
publ i c : 

Object ( voi d ) 
I 

name=NULL; 

I 

Object ( const char *n) 
I 

setNamet n ) ; 

} 

vi rtual -Objects ) 

{ 

if ( name ) 

delete name; 
name = NULL; 

) 

virtual const char *NameC) 

{ 

return name; 

} 

virtual void setName(const char *n) 



if ( name ) 

delete name; 
name = NULL; 

if ( n ) 

{ 

name = new char [strl en ( n )+l ] ; 
strcpy ( name , n ) ; 



class A : public virtual Object 



publ i c : 
A( ) 



Object ("A" ) 



vi rtual ~A( ) 



class B : public virtual Object 
I 

publ i c : 
B( ) 

: Object ("B") 



class C : public A, public B 
1 

publ i c : 
C( ) 
1 
} 

voi d Di spl ay ( ) 

{ 

printf("Name = %s\n", NameO ): 

) 

}; 

int maind'nt argc, char **argv) 

{ 

C c; 

c . Di spl ay ( ) ; 
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The keys to the above code are in the lines 
marked with -* 1 and 2. These two lines force 
he compiler to create only a single Object 
'a»we uffShlinhwitance tree of both A and B. 

ve trie ctrae as IfTile in your code editor and 
close the editor application. 

4. Compile the source-code file with your favorite 
compiler on your favorite operating system, 
and then run the resulting executable. 

If you have done everything right, you should see 
the following output: 

$ . /a . exe 
Name = (null) 

Oops. This is not what we wanted to see. We were 
expecting the name of the class. That name should 
be 'C. The next section fixes that — and gives us the 
type we really wanted. 



Correcting the Code 

The problem in our simple example comes about 
because we assumed that the code would naturally 
follow one of the two paths through the inheritance 
tree and assign a name to the class. With virtual 
inheritance, no such thing happens. The compiler 
has no idea which class we want to assign the name 



to, since the values "belong" to the C class, rather 
than the A and B classes. We have to tell the code 
what to do. Let's do that here. 

1, Reopen the source-code file created earlier 

(called ch22 . cpp) and edit it in your code editor. 

2, Modify the constructor for the C class as follows: 

Object ( "C" ) 



CO 
{ 



3, Recompile and run the program, and you will 
see the following (correct) output from the 
application: 

$ ./a. exe 
Name = C 

It isn't always possible to modify the base classes for 
a given object, but when you can, use this technique 
to avoid the "dread diamond" (having a class derived 
from two base classes both of which derive from 
a common base class) — and use classes that have 
common bases as your own base classes. 



When you're designing a class, keep in mind 
that if you add a virtual method, you should 
always inherit from the class virtually. This 
way, all derived classes will be able to override 
the functionality of that virtual method 
directly. 
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One of the most fascinating abilities that was added to C++ was the 
power to actually change the way the compiler interpreted the 
language. Before C++, if you had a class called, say, Foo, and you 
wanted to write a method or function to add two Foo objects, you would 
have to write code similar to the following: 

Foo addTwoFoos ( const Foo&f 1 , const 

Foo& f2) 

( 

Foo f3; 

// Do something to add the two foos (fl and f2) 
return f3; 

) 

Then you could call the function in your application code like this: 

Foo fl(0) ; 
Foo f 2 ( 1 ) ; 

Foo f3; 

f3 = addTwoFoos(fl ,f2) ; 

Overloaded operators permit you to change the basic syntax of the lan- 
guage, such as changing the way in which the plus operator (+) is used. 
With the addition of overloaded operators, however, you can now write 
something like this: 

Foo operator+( const F00& f 1 , 

const F00& f2 ) 1 



Foo f3; 

// Do something to add them 



return f3; 

} 
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In your code, you can now include statements such 
as this: 



o|T- 




Ithout the overloaded operator (-*■ 1), this line 
would generate a compile error, since the compiler 
knows of no way to add two objects of type Foo. 

Of course, this power comes with a corresponding 
price. When you overload operators like this, even 
the simplest-looking statement can cause problems. 
Because you can no longer assume that a single line 
of code results in a single operation, you must step 
into every line of code in the debugger to trace 
through and see what is really happening. 

Take a look at this simple-looking statement, for exam- 
ple, in which we assign one Foo object to another: 

Foo f 1=12 ; 

This statement could, conceivably, be hidden within 
hundreds of lines of code. If an error crops up in the 
code that processes this simple assignment state- 
ment, you have to dig into every one of those lines 
to find it. So consider: An overloaded operator may 
be hard to beat for readability. It is more intuitive to 
say A+B when you mean to add two things than to 
write a d d ( A , B ) , but it's a debugging nightmare. 
Weigh very carefully the real need for overloading a 
particular operator against the pain you can cause 
someone who's trying to figure out why a side effect 
in your code caused his program not to work. 

Rules for Creating Overloaded 
Operators 

There are four basic rules that you should use when 
you overload operators in your own classes: 

v* Make sure that the operator does not conflict 
with standard usage of that operator. 

This rule is pretty straightforward. If you over- 
load the plus (+) operator, you still expect the 



operator to do something along the line of 
adding. You wouldn't expect (for example) to use 
the plus operator to invert a string; that wouldn't 
make sense. It would drive anyone trying to 
understand the code completely batty. 

Make sure that the operator has no unexpected 
side effects. 

This rule isn't much more complicated. If I'm 
adding two numbers together, I don't expect the 
result of the operation to change either number. 
For example, suppose we wrote something like 

Foo fl(l) ; 
Foo f2(2) ; 
Foo f3 = f 1+f 2 ; 

After these statements are run, you certainly 
would expect f 1 to still contain a 1 and f 2 to still 
contain a 2. It would be confusing and counter- 
intuitive if you added two numbers and found 
that f 1 was now 3 and f 2 was now 5. 

i>* Make sure that an operator is the only way you 
can implement the functionality without having 
an adverse impact on the end user and the 
maintainer of the code. 

This rule is somewhat subjective but easy to 
understand. If you could easily write an algorithm 
as a method or function, there would be no reason 
to overload an operator to perform the algorithm. 

t>* Make sure that the operator and all associated 
operators are implemented. 

This rule is fairly important — especially from 
the perspective of a user. For example, if you 
implement the plus (+) operator, you're going to 
want to implement the plus-equal operator (+=) 
as well. It makes no sense to the end user to be 
able to perform the statement 

Foo f3 = fl + f2; 

without also being able to perform this one: 

f2 += fl; 

Unfortunately, the converse operation is not 
always valid. For example, we might be able to 
add two strings together easily enough, by 
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appending one to the other. What does subtract- 
ing a string from another string mean, though? It 
Id be used to find the string in the first string 
jpt^ftartt b^rt#J»t really doesn't make a 
jtsJll^yBflnV^Jherefore, subtraction is not 
an "associated operator" for strings. This fails 
both the first and third rules. 

Usina Conversion Operators 

Besides addition, the other sort of operator that 
often should be implemented for your classes is a 
conversion operator. With it, you can convert a given 
class into a lot of things. For example, you could con- 
vert a string into a character pointer — or a class 
into an integer for use in other functions. In such 
cases, you use the conversion operator like this: 

operator const char *() 

The const char * portion of the operator defines 
what you are converting the class data into. The 
operator keyword just tells the compiler that you 
are implementing this as an operator. If you imple- 
ment the operator given here in your code, you can 
use the class that implements the code anywhere 
you would use a const char * value. You can do so 
directly, as in the following lines of code: 

printfC'The value as a string is: %s\n", 
(const char *)myObj ) ; 

Alternatively, you can do it implicitly by first includ- 
ing these lines of code: 

void pri nt_a_stri ng ( const char *s ) 

{ 

pri nt ( "stri ng : %s\n", s ); 



and then referencing those lines with this line: 

pri nt_a_stri ng ( myObj ); 



The compiler automatically calls your conversion 
operator "silently" when the object is passed to the 
pri nt_a_stri ng function. The conversion is applied 
and the const char * pointer passed into the function 
instead of the object. Note that this process does 
involve some overhead — and if the conversion is to 
a non-basic type, a temporary object is created — 
which can cause problems if you are reference- 
counting (tracking allocations and de-allocations) 
your objects. You will have a new object created by 
the compiler that does not appear in your code. 
Tracing logic that prints out the creation of objects 
will be confused, and may result in trying to find prob- 
lems by the end programmer that do not really exist. 

Always remember that just because you can use C++ 
functionality, such as overloaded operators, does not 
mean you should or must use that capability. Always 
do what makes the most sense in your programming 
situation. 



Using Overloaded Operators 

Overloaded operators are those that have the same 
name but different numbers or types of arguments. 
Let's create a few overloaded operators in a class to 
illustrate this technique in C++. 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch23, although 
you can use whatever you choose. 

2, Type the code from Listing 23-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 
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Listing 23-1: Overloaded Operators 



#i include <stdio.h> 



l_ ^ #i|ai^de <striig.h> 

DropBooKS 



class MyString 
{ 

char *buffer; 
n'nt length; 
pri vate : 

void SetBuffer( const char *s ) 

if( buffer ) 

delete buffer; 
buffer = NULL; 
length = 0; 

if ( s ) 
{ 

buffer = new char[ strlen(s)+l ]; 
strcpy ( buffer , s ) ; 
length = strlen(buffer) ; 



This code implements the various constructors 
and internal methods that we are going to be 
using in the class. Note that to be a complete 
class, we provide the void constructor (-» 1) 
and copy constructor (-*■ 2), as well as a virtual 
destructor (-> 3). In addition, a variety of other 
constructors allow you to do the complete cre- 
ation of the object in different ways. 

3, Add the code from Listing 23-2. 

In our case, we only have two different pieces 
of data in the class: the buffer itself, which holds 
the string we are encapsulating, and the length 
of the buffer (for keeping track of valid indexes 
into the string). Add the code from Listing 23-2 
to your source file to implement the accessors. 

Listing 23-2: Accessor Methods for the MyString Class 

// Accessor methods 
int LengthU const 



publ 



MyStri ng( voi d ) -» 1 

buffer = NULL; 
length = 0; 

MyString( const char *s ) 

buffer = NULL; 
SetBuf f er ( s ) ; 

// Create a string that is blank, of the 

length given. 
MyString( int length ) 

buffer = new chart length+1 ]; 
for ( int i=0; Klength; ++i ) 
buffer[i ] = ' ' ; 

MyString( const MyString& aCopy ) -* 2 

buffer = NULL; 
SetBuffer ( aCopy. buffer ); 

virtual -MyStringO -* 3 



return length; 

1 

void setLengthtint len) 
f 

if ( len != length ) 
{ 

char *temp = new char[ len+1 ]; 
strncpyt temp, buffer, len ); 
for ( int i=length; n < 1 en ; ++i ) 

temp[i] = 0; 
delete buffer; 
buffer = temp; 



MyString& operator=(const MyString& 
aCopy ) 

SetBuffert aCopy. buffer ); 
return *this; 

// We can overload the operator- as well 
MyString& operator=(const char *str) 

SetBuf f er ( str ) ; 
return *this; 



if ( buffer ) 

delete buffer; 
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4. Add the code from Listing 23-3 to the file. 

This adds the operators for the class. This is an 
)t J)i^*^sU*u mat m^i might or might not want 
It J ipJrloV^Sasses. 




Listing 23-3 implements some operators for this 
class. (We'll add conversion operators, indexing 
operators, an operator to return a sub-string of 
our string, and some comparison operators so 
you can see how it all fits together.) 



Listing 23-3: Class Operators 

// Be able to use the object "just as if" it were a string, 
operator const char*() 
I 

return buffer; 

I 

// Be able to iterate through the string using the [] construct. 
// Note that the users can change the string this way. Define a 
// const version of it too, so they cannot change the string. 
char& operator[]( int index ) 

{ 

// This is probably not the right thing to do, in reality, 

// but if they give us an invalid index, just give them the first byte. 

if ( index < 0 || index > length-1 ) 

return buf f er[0] ; 
return buffer[ index ]; 

} 

const char& operator[]( int index ) const 

{ 

// This is probably not the right thing to do, in reality, 

// but if they give us an invalid index, just give them the first byte. 

if ( index < 0 || index > length-1 ) 

return buf f er[0] ; 
return buffer[ index ]; 

} 

// Now the fun stuff. Create an operator to return a sub-string of the 
// buffer. 

MyString operator( ) ( i nt stlndex, int endlndex) 

{ 

if ( stlndex < 0 || stlndex > length-1 ) 

stlndex = 0; 
if ( endlndex < 0 || endlndex > length-1 ) 

endlndex = 1 ength-1 ; 
if ( stlndex > endlndex ) 
{ 

int temp = stlndex; 
stlndex = endlndex; 
endlndex = temp; 

} 

// Okay, we have valid indices. Let's create the string of the right 
// size. 

MyString s( endlndex-stlndex+l ); 
// Copy the buffer into the string, 
for ( int i=stlndex; i<=endlndex; ++i ) 
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s[i -stlndex] 
return s; 



buf f er[i ] ; 



comparison operators, case-insensitive, 
kconst MyString& aString ) 



if ( LengthO != aStri ng . Length ( ) ) 

return false; 
for ( int i=0; i<Length(); ++i ) 

{ 

char cl = (*thi s ) [i ] ; 
char c2 = aStri ng[i ] ; 
if ( toupper(cl) != toupper(c2 ) ) 
return false; 

} 

return true; 

I 

// Do the same for comparisons to literal strings, 
bool operator==( const char *str) 

{ 

if ( Length( ) != strlen(str) ) 

return false; 
for ( int i=0; i<Length(); ++i ) 

{ 

char cl = (*thi s ) [i ] ; 
char c2 = str[i ] ; 

if ( toupper(cl) != toupper(c2 ) ) 
return false; 



return true; 



Testing the MyString Class 2 - Type the code from Listing 23 4 into your 



After you create the MyStri ng class, you should create 
a test driver that not only ensures that your code is 
correct, but also shows people how to use your code. 

The following steps show you how to create a test 
driver that illustrates how the class is intended to 
be used. 

f m In the code editor of your choice, open the exist- 
ing file to hold the code for your test program. 

In this example, I named the test program ch23. 



Better yet, copy the code from the source file on 
this book's companion Web site. 

Notice that we can use the operator "[]" on 
either side of the equal sign in an expression. If 
you use the [ ] as an 1-value, you can actually 
directly assign values to the buffer in the code. 
However, unlike a "standard" C++ array, the code 
actually validates to ensure that the index you 
pass in is in the valid range for the internal 
buffer. Hence no more buffer overruns — and no 
more program crashes! 

3, Save the source code in your code editor. 
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Listing 23-4: The Buffer Class Test Driver 

void pri nt_a_stri ng( const char *s ) 




g is: % s \ n " , s ); 



int main(int argc, char **argv) 
{ 

MyString s("This is a test"); 

printf("The string is: [%s]\n", (const char *)s ); 
s[4] = •m* ; 

printf("The string is now: [%s]\n", (const char *)s ); 

// Get a sub-string of the string. 
MyStri ng sub = s ( 3 , 7 ) ; 

printf("The sub-string is: [%s]\n", (const char *)sub ); 

// We can reset strings to be bigger or smaller, 
sub = "Hel 1 o worl d" ; 

printf("The sub-string is now: [%s]\n", (const char *)sub ); 

if ( sub == "hEllO world" ) 

pri ntf ( "Stri ngs compareXn"); 

el se 

pri ntf ( "Strings do NOT compareXn"); 
if ( sub == "Goodbye" ) 

pri ntf ( "Stri ngs compareXn"); 

el se 

pri ntf ( "Stri ngs do NOT compareXn" ) ; 
MyString copy = sub; 
if ( sub == copy ) 

pri ntf ( "Stri ngs compareXn"); 

el se 

pri ntf ( "Stri ngs do NOT compareXn"); 

pri nt_a_stri ng( sub ); 
return 0; 

} 



4. Compile the source code with your favorite 
compiler on your favorite operating system. 

5. Run the resulting program on the operating 
system of your choice. 

If you have done everything correctly, you should 
see the following output from the application in the 
console window. 




$ . /a . exe 

The string is: [This is a test] 

The string is now: [Thismis a test] 

The sub-string is: [smis ] 

The sub-string is now: [Hello world] 

Strings compare 

Strings do NOT compare 

Strings compare 

The string is: Hello world 



Testing the My String Class 



As you can see from the output in Listing 23-2, the 
indexing functions (operator [] and operator ()) 
prope^lj^illow us to, retrieve and modify selected 

Eomparison functions work 
Mlf«flcWhljdfiIt\*HA)verloaded operators are 
working correctly 



propedj^illow us to retrievi 



This example really shows the power of overriding 
operators and creating your own types in C++: You 
can protect the end user against just about all the 
problems that have cropped up in years of software 
development. 
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One basic building block of the C++ language is a set of core 
keywords for allocating and freeing blocks of memory. The new 
and delete keywords (for example) were added to the language 
primarily to support the addition of objects with constructors and 
destructors — but they're also used to allocate more "generic" blocks of 
memory, such as character arrays. 

The main reason for using the new operator was that it would automatically 
allocate the needed block of memory, and then call the constructor for 
the block of memory to initialize it properly (The old C style al 1 oc/mal 1 oc 
functions couldn't do that.) 

The problem with the new and del ete operators isn't really in the way 
they are used; it's that they don't keep track of what is allocated and 
what is deleted. There are other problems — such as dealing with pools 
of objects (allowing you to reuse objects without allocating new ones) — 
but most programmers would agree that the issue of tracking memory 
allocation is more serious. If you can keep track of exactly when memory 
is allocated and de-allocated in your application, you will save enormous 
amounts of time in the debugging process trying to track down memory 
leaks and overwrites. 

Consider, as a good example, the following function, written in C++: 

int funcd'nt x) 



char *ptr = new char[200]; 
if ( x < 0 | | x > 100 ) 
return -1; 



1 

2 



// Do some processing of the ptr. 



// De-allocate memory, 
delete ptr; 

} 
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This code contains a subtle, but important, memory 
leak. If you call the function with a value such as 102 
passed-fjDr x, you will see the problem. The function 
l|0^|asciJ11*(jif\fnrfe^ry that is 200 bytes long 
l«rW Je\ta*6 without de-allocating the 
block (at -> 2). That memory is then consumed until 
the program exits, and is no longer available to the 
application. This might not seem like such a big 
problem — unless this routine is called several thou- 
sand times. Suddenly that 200-byte block becomes a 
several-megaftyfe memory leak. Not a good outcome 
at all. 

Fortunately, the designers of C++ considered that 
problems like this could easily crop up. Although 
they chose not to build in a garbage-collection sys- 
tem, as in Java, they did provide the building blocks 
for creating your own memory allocation and de- 
allocation system, and keeping track of such things. 
To keep track of memory allocation in C++, we need 
the ability to overload the new and del ete handlers 
in the language. You might think that this would be a 
complicated affair, but as Technique 23 shows, over- 
loading operators (so they appear to be a basic part 
of the language) is simple in C++. The new and del ete 
operators are no exception to the overloading 
process, although you have to go about it a little dif- 
ferently. In this technique, we look at how you can 
overload the new and del ete handlers for the entire 
system, although the same process can be scaled 
down to just the class level. 

Rules for Implementing neu/ 
and delete Handlers 

There are a few things to note when you are imple- 
menting your own new and del ete handlers in your 
application code. 

V* You may not call new and del ete within your new 
or del ete handlers. This might seem obvious, 
but issuing those calls is almost automatic for 



some developers. In short, new and del ete may 
not be called recursively. 

You may not call any methods, functions, or 
objects that call new or delete within your han- 
dlers. If you call a function within a new handler 
that calls new, you get an instantly recursive call. 
Following this rule is often harder than it looks. 
(For example, you cannot use the STL containers 
because they allocate memory.) 

Your new and del ete handlers must be very fast. 
Their code is often called over and over, and 
must not slow down the application they are 
being used from. 

You cannot change the process in which the new 
and del ete operators are called. That is, you 
can't return a smaller or larger block than was 
asked for to the application. Doing so can break 
many programs. 



Overloading neu/ and 
delete Handlers 

With these rules in mind, how can we overload the 
new and delete operators to keep track of what is 
being allocated in a given program and report on 
which allocations were never freed? Let's take a look 
at an example of that right now. 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch24 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 24-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 
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Listing 24-1: new and delete Handlers 



#include <stdio.h> 
#inp4*de <stdl -*b . h> 




long number; 
long address; 
long size; 
char file[64]; 
long line; 
} 1ALL0C_INF0; 

1ALL0C_INF0 *allocations[ 100000 ]: 
int nPos = 0; 



void AddTrack( 1 ong addr, long asize) 

{ 

if ( asize == 2688 ) 

pri ntf( " Found one!\n"); 
1ALL0C_INF0 *info = (1ALL0C_INF0 * )ma 1 1 oc ( s i zeof ( 1 ALL0C_I N F0 ) ) ; 
i nfo->address = addr; 
info->size = asize; 
i nf o->number = nPos ; 
al 1 ocati ons [nPos ] = info; 
nPos ++; 

■■"■^^^ ^^^mmtm 

bool Removef rack( 1 ong addr) 
bool bFound = false; 

ford'nt i = 0; i != nPos; i++) 

{ 

i f( al 1 ocati ons [i ] ->address == addr) 

{ 

// Okay, delete this one. 
f ree( al 1 ocati ons [i ] ) ; 
bFound = true; 

// And copy the rest down to it. 
for ( int j=i ; j<nPos-l; ++j ) 

al 1 ocati ons[j ] = al 1 ocati ons[j+l ] ; 
nPos --; 
break; 

} 

} 

if ( ! bFound ) 

pri ntf ( "Unabl e to find allocation for delete [%ld]\n" ,addr) ; 
return bFound; 
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This code keeps track of all allocations — and 
adds or removes them from a global array as we 
pur processing. This way, we can track all 

e within our application — 
ft\j»cJlls to new that are not 
matched with a call to delete. Of course, this 
approach limits how many allocations we are 
going to track (it's a large, but not infinite, num- 
ber). We can't dynamically allocate this array 
without writing a bunch of fancy code that's 
beyond the scope of this example, so we will use 
this compromise for now. 

3. Add the code from Listing 24-2 to your source 
file. 

This code generates a report of what blocks are 
currently allocated and how big they are. This 
aids the developer in tracking down the offending 
code that created the memory leak in the first 
place. Of course, knowing where the leak 
occurred doesn't help if the leak happens in a low- 
level library (because we have no access to the 
library source code and couldn't modify it if we 
did), but at least the size will help some. By know- 
ing the size of our allocation, we might be able to 
map that to a specific block size in the program, 



or the size of a given object. This code could eas- 
ily be moved to a separate utility file but we will 
include it in the same file for simplicity. 

This code simply steps through the list of alloca- 
tions we have kept track of in the add and remove 
routines and reports on anything it finds that 
was not yet freed. This doesn't necessarily mean 
that the allocation is a leak, though, as we will 
see. What it means is that at the moment of this 
particular memory-state snapshot, the alloca- 
tions in the list have not been freed up. 

4, Add the code from Listing 24-3 to your source 
file below the remaining code. 

This implements the actual new and del ete 
methods. Once again, we could easily move 
these to a separate utility file, but it is easier to 
leave it in one place. This functionality is added 
separately to indicate how you would append 
this code to an existing program. 

This will implement the actual overload of the 
new and delete operators. To implement that 
operation, add the code in Listing 24-3 to your 
source file. 



Listing 24-2: Allocation Report 

voi d DumpUnf reed( ) 

{ 

1 ong total Si ze = 0 ; 

printfC Allocations \n"); 

ford'nt i = 0; i < nPos; i++) 

{ 

1ALL0C_INF0 *pInfo = al 1 ocati ons [ i ] ; 

pn'ntf("(%ld) ADDRESS %x\t Size: %d unfreed\n", 

pInfo->number , pInfo->address , pInfo->size) ; 
totalSize += pInfo->size; 

} 

pri ntf ( " \n"); 

pri ntf( "Total Unfreed: %d bytes\n\n\n " , totalSize); 
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Listing 24-3: Overloaded new and delete Handlers 



inline void * cdecl operator new(unsigned int size) 



DropBaoks 

ArlHT^ar-W M n n n ~l n + 



rator new cal 1 ed\n " ) ; 
*)mal 1 oc(size) ; 
AddTrack( (1 ong)ptr, size); 
return ( ptr ) ; 



inline void * cdecl operator new[] ( unsi gned int size) 

{ 

pri ntf( "Array operator new called\n"); 
void *ptr = (void *)mal 1 oc(size) ; 
AddTrack( ( 1 ong ) ptr , size); 
return ( ptr ) ; 

}; 

inline void cdecl operator delete(void *p) 

{ 

pri ntf ( "Basi c operator delete called\n"); 
if ( RemoveTrack( ( 1 ong ) p ) ) 
free(p) ; 

}; 

inline void cdecl operator delete[](void *p) 

{ 

pri ntf ( "Array operator delete called\n"); 
if ( ReinoveTrack( ( 1 ong ) p ) ) 
free(p) ; 



S. Save the source-code file. 

These implementations of the code are nothing spe- 
cial. We simply allocate memory (using the built-in 
C function mal 1 oc) and de-allocate the memory by 
using the free function. The code includes some 
debugging pri ntf statements that allow you to show 
which functions are being called at what time. 
Within each allocation or de-allocation operator, we 
call the appropriate tracking function to add or 
remove this particular allocation from the global 
array. One thing to note is that this code is actually 
better than the standard C++ implementation, 
because it verifies that a given pointer was allocated 
before it allows it to be freed. You could (for exam- 
ple) cause some mayhem if you were to do this: 



char *c = new c[100] ; 

// Do some stuff 
delete c; 

// Do some more stuff 
delete c; 

Expect bad things to happen in a case like this: It's 
deleting the same pointer twice, which tends to cor- 
rupt the stack and destroy all memory in the system. 
In our system, however, this process is caught and an 
error message is displayed. Furthermore, the actual 
pointer is not deleted a second time — so there's no 
memory corruption in the system and your program 
does not crash. That's a good enough reason to use a 
system like this in your production code. 
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All production code should be tested with a 
/ -m memory-leak tool, or run through code like 
A ^ ' _ttiis to see whether memory is being allocated 
, not freed correctly, or 
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Tracker 

In order to see how the allocation tracking code 
works, it is easiest to create a simple test driver that 
illustrates the various pieces of the system. Let's cre- 
ate a simple test program to use the new and del ete 
handlers we have created. The following steps show 
you how: 

f m In the code editor of your choice, open the exist- 
ing file to hold the code for your test program. 

In this example, I named the test program CH 24. 

2. Type the code from Listing 24-4 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

3. Save the source code and close your code editor. 



Listing 24-4: Memory Allocator Test Driver 

int maintint argc, char **argv) 
{ 

DumpUnf reed ( ) ; 

char *c = new char[200]; 

DumpUnf reed ( ) ; 

char *c2 = new char[256]; 

DumpUnf reed ( ) ; 

delete c; 

delete c; 

DumpUnf reed ( ) ; 

int *x = new int [20] ; 

delete [] x; 

DumpUnf reed ( ) ; 

Foo *f = new Foot ) ; 

delete f; 

Foo *af = new Foo[5] ; 
delete [] af; 

Foo *af 1 = new Foo[3] ; 
delete afl; 



4. Compile the source file, using your favorite 
compiler on your favorite operating system. 

If you run the resulting executable, the program 
should give you the output shown in Listing 24-5. 



Listing 24-5: Output from the Memory Tracking Program 



$ ./a.exe 



Total Unfreed: 0 bytes 



Al 1 ocati ons 



Array operator new called 

Allocations 

(0) ADDRESS a050648 Size: 200 unfreed 



Total Unfreed: 200 bytes 



Array operator new called 
Allocations 

(0) ADDRESS a050648 Size: 200 unfreed 

(1) ADDRESS a050770 Size: 256 unfreed 



(continued) 
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Listing 24-5 (continued) 



Total Unfreed: 456 bytes 
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called 

'Basic operator delete called 
Unable to find allocation for delete [168101448] 

Allocations 

(1) ADDRESS a050770 Size: 256 unfreed 

Total Unfreed: 256 bytes 



Array operator new called 
Array operator delete called 

Allocations 

(1) ADDRESS a050770 Size: 256 unfreed 



Total Unfreed: 256 bytes -> 4 



Basic operator new called 
Foo Constructor called 
Foo Destructor called 
Basic operator delete called 



Array operator i 


lew called 


Foo 


Constructor 


called 


Foo 


Constructor 


called 


Foo 


Constructor 


called 


Foo 


Constructor 


called 


Foo 


Constructor 


called 


Foo 


Destructor i 


;a 1 led 


Foo 


Destructor i 


:al 1 ed 


Foo 


Destructor called 


Foo 


Destructor called 


Foo 


Destructor called 


Array operator delete called 



There are a lot of interesting things to take out of 
this technique. First, it gives you a better apprecia- 
tion of what goes on behind the scenes in a typical 
C++ program. Second, you can see right away how 
the allocations and de-allocations are being handled 
and where the leaks are. In our example, we can see 
at the end of the program that we have a single 
memory leak of 256 bytes (at -> 4 in Listing 24-5). 
Note that we print out the current state of the pro- 
gram several times, so it is only the last display that 
indicates the leak at the end of the program. The 



others are left in to illustrate how the program is 
allocating memory. It's obvious, from looking at the 
program code, that this occurs for the c2 allocation 
(see -> 3 in Listing 24-4). We simply need to add a 
del ete call for the character pointer and all will be 
copacetic. 

The other interesting thing to note in this technique 
is which C++ new operator is called when. If you allo- 
cate a character pointer, for example, it calls the 
array version of the new operator. This situation is 
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counterintuitive — after all, you're allocating a single 
character pointer — but it makes sense if you really 

_ of characters that we 
string, which gives us the 
perator. Likewise, when we 
allocate a single object, it calls the basic operator for 
the new allocation. 



think about it. It's an array ( 



Before we leave this concept, there's one more 
potential mess worth looking at. Try adding the fol- 
lowing code to the end of your driver application: 

Foo *af 1 = new Foo[3] ; 
delete afl; 

If you compile this snippet of code at the end of your 
driver program, and then run the program, you will 
see the following output: 

Array operator new called 
Foo Constructor called 
Foo Constructor called 
Foo Constructor called 
Foo Destructor called 
Basic operator delete called 
Unable to find allocation for delete 
[168101480] 




Looking at the output, you will notice that the con- 
structor for the class was called three times, for the 
three objects we created. The destructor, however, 
was only called once. Worse, because the block of 
memory allocated is actually three separate objects, 
our deletion routine couldn't find it to delete it. 



Moral: Always call the right version of del ete 
for the corresponding version of new. 



The new new operator 

In C++, there is another version of the new operator called 
the new in pi ace operator. This operator invokes the con- 
structor for an object and sets it to point to a specific block 
of memory that is passed into it. If you are implementing a 
system that uses an embedded processor, where you can- 
not "really" allocate memory, or if you have an object pool, 
you might consider such a choice. 



Add a memory tracker to every application 
you create. You can conditionally compile in 
the code to see how things are going at any 
stage of the application-development phase, 
and can use the resulting reports for quality 
assurance. 
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If you are accustomed to programming in the "new" languages, such as 
Java or C#, you are probably already familiar with the concept of 
properties. Essentially, properties are public elements of a class that 
have their own methods for getting and setting their values. Unlike tradi- 
tional public values, however, a property cannot be accessed directly by 
the programmer — even though it looks like it can. A property has set 
and get functions that are invoked when you attempt to write or read to 
the property values. C++ has no direct implementation of properties in 
the language. This is really a shame, because properties save a lot of 
time for the end user by making it easier to read and write data values 
within the class. 

For example, suppose you have a class named Foo that contains a prop- 
erty called age. This property can be set by the application developer, 
but only to values within the range of (say) 18 to 80. Now, in a "standard" 
C++ application, you could define the class with a public member such as 
in the following: 



class Foo 
( 

publ i c : 
Foo( ) 
( 
} 

int age; 



If you had such a class, you could then write application code to directly 
set the age property, like this: 

int main( ) 



Foo f; 
f.age = 22; 
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The problem is, you can also set age to an invalid 
value. The restriction is only implemented by the 
"rule" Ua^t an age can't be outside the valid range of 

)t enforce this rule, which 
is in calculations that rely 
on the rule being obeyed. An invalid assignment 
might look like this: 



"rule" |i)at an age can't be o 



f .age = 10; // Inval id 

The ideal solution would be to allow people to 
directly set the age property in this class, but not 
allow them to set it to values outside the valid range. 
For example, if a user did so and then added this 
statement 



f .age 



10; 



the age would not be set and would retain its old 
value. This resistance to unauthorized change is the 
advantage of a property, instead of allowing the 
value to change no matter what input value is given. 
In addition, we can create read-only properties that 
can be read but not written to. C++ does not offer 
this capability directly, but it allows us to create 
such a thing ourselves. A read-only property would 



be useful for values that the programmer needs 
access to, but cannot possibly modify, such as the 
total memory available in the system. Properties like 
these save time by making the code easier to read 
while still maintaining data integrity. 

Implementing Properties 

Creating a simple class that implements properties 
for a specific type — in this case, integers — can 
illustrate this C++ capability. We can then customize 
the class to allow only specific types of integers, or 
integer values. 

In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch25 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 25-1 into your file. 

Or better yet, copy the code from the source file 
on this book's companion Web site. 



Listing 25-1: Property Class 

#include <stdio.h> 
#include <string> 

class IntProperty 
{ 

int temp; 
int &i Value; 
bool bWrite; 
publ i c : 

void I n i t ( ) 
{ 

bWri te = false; 

I 

IntProperty(void) 
: iVal ue(temp) 

{ 

I n i t ( ) ; 

} 



(continued) 
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Listing 25-1 (continued) 



rtual voigd sett i nt i ) 




publ 



virtual int get(void) 
return iValue; 



ntProperty ( i nt& i ) 
: i V a 1 u e ( i ) 

Init( ) ; 

ntProperty( int i, bool read, bool write ) 
: i V a 1 u e ( i ) 

Init( ) ; 

ntProperty( const IntProperty& aCopy ) 
: i Val ue( aCopy . i Val ue ) 

Init( ) ; 

virtual -IntProperty ( ) 



/ Accessors 

nt getValuet void ) 

return iValue; 

bool getWrite(void) 

return bWrite; 

void setWrite(bool write) 

bWri te=wri te ; 



/ Operators 

ntProperty& operator=( int i ) 



if( bWrite ) 
sett i ) ; 
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else 

pri ntf ( "Try i ng to assign to a read-only property\n" ) ; 




operator into 



return get ( ) ; 

) 

) ; 



This class implements a property according to 
the C++ standards, and yet works as if it were a 
Java or C# property. We will be able to read and 
write to the data value without having to write 
extra code, but the data values will be validated 
for the range allowed. To use it, we need to 
embed it in a class that the end user will interact 
with. This class will expose the IntProperty 
object to the end user, but the instance of the 
IntProperty class within any other class will 
work with an internal variable of that class. The 
IntProperty class is really just a wrapper 
around a reference to a variable, but that vari- 
able will be outside the scope of the 
IntProperty class. 

Notice that the set (-* 1) and get (-*■ 2) meth- 
ods of the class are internal to the class itself, 
but are also declared as virtual. That means 
implementing a derived class that screens out 
certain data values would be trivial, as we 
will see in the AgeProperty class later in this 
technique. 

To derive a class from our IntProperty class, we 
just have to override the get and set methods in 
the ways we want. To restrict the range of the 
integer value, for example, we modify the set 
method to only allow the values we permit. In 
addition, we must override the opera to r= 
method, because operator- is never inherited 
by a derived class. That's because you could be 
setting only a portion of the object — which the 
language won't let you do, so you have to over- 
ride the operator as well. When you create a 



derived class, the operator- would be called for 
the base class. This would set only the member 
variables in the base class, and would not set the 
ones in the derived class. Otherwise, the remain- 
der of the class remains the same. 

3. Add the code from Listing 25-2 to your source 
file. 

We could simply create a new file to store this 
new class, but it is easier to just combine them 
for the purpose of this technique. 

In this case, we are going to use the IntProperty 
in another class. 

Listing 25-2: Extending the IntProperty Class 

class AgeProperty : public IntProperty 
{ 

pri vate : 

virtual void s e t ( i n t i ) 
{ 

if ( i >= 18 && i <= 80 ) 
IntProperty: :set(i ) ; 

1 

publ i c : 

AgePropertyt int &var ) 
: IntProperty (var) 

{ 
} 

AgeProperty& operator=( int 1 ) 
{ 

IntProperty: :operator=(i ) ; 
return *this; 

} 
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class, ajjdJJrovide it. with a c 

DrQ0;B,QOkS: 



Now, in order to use the class, we need to embed the 
object as a public member of our encapsulating 
class, ajj^provide it. with a data member that it can 
— es. The property class is 
Hue. Because it contains a 
reference to a data value outside the class, it can 
directly modify data in another class. That means 
that any changes made to the reference in the 
IntProperty class will be immediately reflected in 
the underlying class-member variable. 

To show how it all fits together, the next section 
adds a class that makes use of the Age Property class. 



Testing the Property Class 

After we have defined the Property class, we need to 
test it. The following steps show you how: 



3. 



This class contains a single integer value, its only 
data member. The data member is associated 
with the Property class in the constructor for the 
class, so any changes to the member variable will 
be immediately reflected in the Property class 
and theTestlntValueclassatthe same time. 

Because the data value is used by reference in 
the Property class, changing the property is the 
equivalent of changing the original data member 
directly. We are controlling how the data is 
changed, while allowing the compiler to generate 
the code that does the actual data manipulation. 

Our class illustrates how the data values change 
and what they are assigned to at any given 
moment in time. We will use this class to show 
off how the property class works. 

Add the code from Listing 25-4 to the end of 
your existing file. 



f m In the code editor of your choice, create a new 
file to hold the code for your test program. 

In this example, I named the test program 

ch25 . cpp. 

2. Put the code from Listing 25-3 into your test- 
driver file. 

Listing 25-3: Testing the IntValue Class 

class TestlntVal lie 

{ 

pri vate : 

int mylnt; 
publ i c : 

TestlntVal ue( ) 
: i ( my I n t ) 

{ 

mylnt = 0; 



Listing 25-4: The Test Driver Code 



int maindnt argc, char **argv) 
1 

TestlntValue tiv; 
tiv.i = 23; 

pri ntf ( "Val ue = %d\n", (int)tiv.i ); 

ti v . Print( ) ; 

ti v . i . setWri te( true ) ; 

tiv.i = 23; 

pri ntf ( "Val ue = %d\n", (int)tiv.i ): 

int x = tiv.i; 

ti v . Print( ) ; 

pri ntf ( "X = %d\n" , x ) ; 

tiv.i = 99; 

pri ntf ( "Val ue = %d\n", (int)tiv.i ): 



void P r i n t ( ) 

{ 

pri ntf ( "mylnt = M\n", mylnt ); 



publ i c : 

AgeProperty i 



4. Save the source file in your code editor and 
close the editor application. 

5. Compile the file with your favorite compiler on 
your favorite operating system. 

If you have done everything properly, you should 
see the following output from the application: 
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$ . /a . exe 

Trying to assign to a read-only property 
Value = 0 
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X = 23 
Value = 23 

The output above illustrates that our property class 
is working properly. The initial value of the integer is 
0, as specified in the constructor. Because the class 
defaulted to read-only (setWri te was not yet called), 
an attempt to write to the variable (-> 3) results in 
no change being made (-*■ 4). After we set the write 




flag to allow changes (-> 5), we can then assign val- 
ues to the variable and have it modified in the out- 
put 6). 



Properties are an essential part of languages 
such as C# and Java, but are not yet a part of 
the C++ languages. If you get into the habit of 
thinking about them, however, you can save a 
lot of time in the long run — for one thing, you 
won't have to relearn how to use data mem- 
bers for classes. Translating code to and from 
C++ from the newer languages will become 
an essential part of mixed language projects in 
the future, and making it easy to do that trans- 
lation will save you a lot of time and effort. 
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Data validation is one of the most basic and pervasive functions of a 
computer program. Before you can operate on a given piece of 
data, you need to know whether or not it is valid. It doesn't matter 
if it is a date, a time, an age, or a Social Security number; the data you 
accept into your program will cause problems if it is in an invalid format. 

Validating a data type is a perfect form of encapsulation, which makes it a 
perfect task to assign to a C++ class. Because we encapsulate both the 
data and the rules for the data type within a class, we can move that class 
from project to project, anywhere that the data type is needed. This saves 
time in implementing the class, as well as time and effort in validating and 
testing the class. 



When you're writing an application, take time to identify the data 
types you're using. Write classes to validate, save, and load these data 
types and you will save yourself endless time debugging and extend- 
ing your applications. 




Implementing Data Validation With Classes 

Follow these steps to create your own validation classes: 

/. In the code editor of your choice, create a new file to hold the code 
for your header file. 

In this example, I call my class ch26 . cpp. 

2. Type the code from Listing 26-1 into your file. 

Better yet, copy the code from the source file on this book's compan- 
ion Web site. 
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Listing 26-1: The Validation Class 



#include <string> 
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' #define SSN_DELIMITER 



this val i dati on 



// The validator class 
class SSNValidator 
{ 

// Internal member variables 
private: 

// This is the actual SSN. 
std : : stri ng _ssn ; 

// This is the flag indicating validity, 
bool _valid; 



protected : 
bool 



IsVal id(const char *strSSN); 



publ i c : 

// Constructors and destructor 
SSNVal idatort ) ; 

SSNVal idatort const char *ssn ); 

SSNVal i dator ( const std::string& ssn ); 

SSNVal idatort const SSNVal idator& aCopy 
virtual -SSNVal idator( ) ; 

// Accessors for this class 
bool ValidU { return _valid; ); 

std::string SSNO { return _ssn; (; 
void setSSNt const char *ssn); 



// Operators for this class 



SSNVal idator 
SSNVal idator 
SSNVal idator 



operator 
operator 
operator 



const char *ssn ) ; 

const std::string& ssn ); 

const SSNVal i dator& aCopy 



operator const char *(); 



3, Save your code in the code editor. 

This will be the definition for our Val idator 
object. This class can then be included in other 
modules to do validation of the type we are 
defining. In this example, we are validating a U.S. 
Social Security Number. 



4. Type the code from Listing 26-2 into your new 
file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 
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Listing 26-2: Social Security Number Validator 



^include <ctype.h> 

;Val i d( const char *strSSN) 
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i nt l : 

// No NULL values allowed, 
if ( strSSN == NULL ) 
return false; 

// Copy the result into a string, removing all delimiters, 
std : : stri ng sSSN ; 

for ( i=0; i<(int)strlen(strSSN) ; ++i ) 
if ( strSSN[i] != SSN_DELIMITER ) 
sSSN += strSSN[i]; 



// Must be 9 characters, 
if ( strlen(sSSN.c_str()) != SSN_LENGTH ) 
return false; 

// Check to see whether all characters are numeric, 
for ( i=0; i <( int)strl en(sSSN .c_str( ) ) ; ++i ) 
if ( !isdigit( sSSN [ i ] ) ) 
return false; 



// Must be okay, 
return true; 



// Constructors and destructor 
SSNVal idator: : SSNVal i dator( ) 
{ 

_ssn = ""; 
_val id = false; 



} 



SSNVal i dator :: SSNVal i dator( const char *ssn ) 
{ 

// Only assign if valid. 
_val i d = IsVal i d( ssn ) ; 
if ( _val id ) 
_ssn = ssn; 

} 



SSNVal i dator :: SSNVal i dator( const std::string& ssn ) 
{ 

// Only assign if valid. 
_valid = IsValid( ssn.c_str() ); 
if ( _val id ) 
_ssn = ssn; 

} 



SSNVal idator: : SSNVal idator( const SSNVal i dator& aCopy ) 
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_ssn = aCopy._ssn; 
.valid = aCopy ._val i d ; 




jSNva i icratoTT:~S~mral idatort ) 
[ 
1 



void SSNVal idator: :setSSN( const char *ssn) 

{ 

// Only assign if valid, 
if ( IsValidt ssn ) ) 
{ 

_val id = true; 
_ssn = ssn; 




// Operators for this class 

SSNValidator SSNVal idator: :operator=( const char *ssn ) 

{ 

// Only assign if valid, 
if ( IsValidt ssn ) ) 
{ 

_val id = true; 
_ssn = ssn; 

) 

return *this; 

} 

SSNValidator SSNVal idator: :operator=( const std::string& ssn ) 

{ 

// Only assign if valid. 

if ( IsValidt ssn.c_str() ) ) 

{ 

_val id = true; 
_ssn = ssn; 

} 

return *this; 

} 

SSNValidator SSNVal idator: :operator=( const SSNVal idator& aCopy ) 

{ 

_valid = aCopy ._val id; 
_ssn = aCopy._ssn; 
return *this; 

} 

SSNVal idator: :operator const char *() 

{ 

return _ssn . c_str ( ) ; 

} 
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S. Save your code and close the code editor. 

The file we just defined will be a real type that 
~~ ^aji^s*^n|y»iu«^wn applications to store 

^ 1 \i/ £ %elf c \ft^curity Numbers (SSNs). You 
will never again have to write code to check the 
length of an entry or its contents to see whether 
it could be a valid SSN value. 



Create a new type for every kind of data you 
will accept and process in your application. 
Create a validator for the data type that can be 
moved from project to project. 

Note that we provided constants for both the 
length of the SSN and its delimiter (see lines 
marked -* 1 and -* 2). This allows you to easily 
modify the code if the format of the SSN changes 
over time. Someday you may need to change the 
SSN to use more digits, or to be formatted with a 
different delimiter. Preparing for this now saves 
you huge amounts of time later. 

Never hard-code values into your applications; 
always use constants that can be easily 
changed at compile-time. 




Testing \lour SSN Validator Class 

After you create the Val i dator class, you should cre- 
ate a test driver to ensure that your code is correct 
and show people how to use your code. 

Creating a test driver will illustrate the validation of 
various kinds of input from the user, and will show 
how the Val i dator class is intended to be used. The 
driver will contain some basic tests of the class, as 
well as accepting Social Security Numbers from the 
user to see whether they are valid or not. 

In this example, we create a test driver that does two 
things. First, it creates a standard battery of tests 
that illustrates the expected good and bad entries 
for the type. Second, the test driver allows the pro- 
grammer to try other styles of entry to see whether 
the class catches them. 

/. In the code editor of your choice, reopen the 
file to hold the code for your test program. 

In this example, I named the test program 

ch26 . cpp. 

2, Append the code from Listing 26-3 into your test 
driver file, substituting the names you used for 
your SSN class definition where appropriate. 

Better yet, copy the code you find from the 
source file on this book's companion Web site. 



Listing 26-3: The Test Driver Code 



const char *TrueOrFal se( bool value ) 
{ 

if ( value ) 

return "TRUE"; 
return "FALSE"; 

} 

void DoValidTest( const char *strName, SSNVal idator& ssn, bool expected_resul t ) 

{ 

bool bVal id = ssn. Val id( ) ; 

printf("%s: Result %s. Expected Result: %s. %s\n", strName, 
TrueOrFalse( bValid ), TrueOrFalse( expected_resul t ), 
( bValid == expected_resul t ? "PASS" : "FAIL" ) ); 

} 
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int mainO'nt argc, char **argv) 



if ( argc < 2 ) 
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e: ch3_15 ssnl [ssn2]...\n"); 



for ( int i=l; i<argc; ++i ) 

^^^^^^^^^^^^^^^^^^^^ 
SSNVal i dator ssn(argv[i ] ) ; 

if ( ssn.ValidO ) 

printf("%s is a valid Social Security Number\n", ssn.SSNt ) .c_str( ) ); 



el se 



printf("%s is NOf a valid Social Security Number\n", argv[i] ); 



// Do some generic testing. 

SSNVal idator ssnNULU NULL ) ; 

DoValidfest( "NULLfest", ssnNULL, false ); 

SSNVal idator ssnGood( "000-00-0000" ) ; 

DoValidfest( "Good Test", ssnGood, true ); 

SSNVal idator ssnBad( "OOOOaOOOO" ) ; 

DoValidTest( "Bad Test", ssnBad, false ); 



return 0; 



3. Save your test driver file in the code editor and 
close the code-editor program. 

4. Compile the test program with your chosen 
compiler and run it on your chosen operating 
system. 

Enter command-line arguments, such as 

123456789 000-00-0000 0909 al2345678 
012-03-3456 

These are simply forms of the Social Security 
Number, some valid and some invalid. The first one, 
containing nine digits and no alphanumeric charac- 
ters, will be valid. The third argument does not con- 
tain nine characters and is therefore invalid. The 
fourth contains an invalid character (a). The second 
and fifth entries look valid, but we do not handle the 
dash character, so they will be deemed invalid by the 
program. 



If your program is working properly, you should see 
the output from the test driver as shown in Listing 
26-4. 



Listing 26-4: Output from the Test Driver 

$ ./a 123456789 000-00-000 0909 al2345678 
01-02-2345 

123456789 is a valid Social Security Number 

000- 00-000 is NOT a valid Social Security 
Number 

0909 is NOT a valid Social Security Number 
al2345678 is NOT a valid Social Security 
Number 

01- 02-2345 is NOT a valid Social Security 
Number 

NULL Test: Result FALSE. Expected Result: 

FALSE. PASS 
Good Test: Result TRUE. Expected Result: 

TRUE. PASS 

Bad Test: Result FALSE. Expected Result: 
FALSE. PASS 
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As you can see by the output, the program first 
checks the input arguments from the user. As we 
expecte^only the fu'st input value was valid. All 

I KT^If^P'S'^Ffl i^C^ invalid. The remaining 
I—/ I Vt e Ae^BiqMyWalm«B:a N&faKnown conditions work 
properly. 



r 

V 



I recommend that you create generic test driv- 
ers for all your validators, so when changes are 
made to accommodate new formats, the driv- 
ers will be prepared in advance to test them. 
This will save a lot of time in the long run, and 
will allow for automated testing. 
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Building a bate 
Class 



Save Time By 

f* Creating a generic Date 
class 

V Implementing date func- 
tionality into your class 

V Testing your class 



One of the most common tasks that you will run into as a program- 
mer is working with dates. Whether you are calculating when 
something is bought or sold, or validating input from the user, your 
application will probably need to support dates. The standard C library 
contains various routines for working with dates, such as the ti me and 
1 ocal time functions. The problem, however, is that these routines do not 
perform adequate validation — and for that matter, they are not easy to 
use. It would be nice, therefore, to create a single class that implemented 
all the date functionality that we wanted in our applications. By creating a 
single class that can be easily ported from project to project, you will save 
time in the development, design, and testing phases of the project. 

Because dates are a fundamental building block of our applications, it 
makes sense to create a single class that would manipulate them and vali- 
date them. If you were to make a list of all of the basic functionality you 
would like in such a class, you would probably have something like this: 

Validate dates 
*<" Perform date math calculations 
Compute the day of the week 
Return day and month names 
Convert numeric dates to strings 

Many other functions exist that would be useful, but these are the most 
critical in any application. In this technique, we look at the ways you can 
utilize a Date class in your own applications — and how you can imple- 
ment the functionality needed to do everything on our feature list for a 
Date class. 

You can save huge amounts of time by creating classes that not only 
p / -a) validate input, but also manipulate it numerically. By creating a class 



jky that allows you to add to, or subtract from, a date in your code 

directly, you do accounting calculations and timing routines in a flash, 
without any additional coding. 
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Creating the bate Class 

Drc^BOD'kS! 



e your own personal Date 



f m In the code editor of your choice, create a new 
file to hold the code for the Date class. 

In this example, the file is named ch27 . h, 
although you can use whatever you choose. 

2. Type the code from Listing 27-1 into your file. 

Better yet, copy the code you find in the source 
file on this book's companion Web site. Change 



the names of the constants and variables as you 


choose. 




Listing 27-1: The Date Class Definition 


#ifndef CH27H_ 




//define CH27H_ 




//include <string> 


const int MaxMonths = 12; 


const int MaxYear = 9999; 


typedef enum 
{ 




MMDDYYYY = ( 


), 


DDMMYYYY = 1 


L, 


YYYYMMDD = 1 


; 


) DateFormat; 




class Date 




{ 

pri vate : 




// Store dates in Julian format. 


1 ong 


_ j u 1 i a n ; 


// The month of the year (0-11) 


i nt 


_month ; 


// The day of the month (0-30) 


i nt 


_day_of_month ; 


// The day of the week (0-6) 


i nt 


_day_of_week ; 


// The year 


of the date (0-9999) 


i nt 


_yea r ; 


// A string 


representation of the date 


std : : stri ng 


_stri ng_date ; 


// The format to use in the date 


DateFormat 


_f ormat ; 



// See whether a given date is 
bool IsValidO'nt m, int d, int 
// Compute the day of the week, 
int Day0fWeek( int m, int d, int 
// Convert to Julian format. 
1 ong ToJul i an ( ) ; 

// Convert from a Julian format. 

voi d FromJul i an ( ) ; 

// Initialize to defaults. 

void Init(void); 

// Make a copy of this date. 

void Copy( const Date& aCopy ); 

// Convert to a string, 
const char *ToString(); 



valid. 

y); 



y ): 



publ i c : 



// Constructors and destructors 
Date( ) ; 

Date( int m, int d, int y ); 
Date( const Date& aCopy ); 
Date( 1 ong jul i an ) ; 
vi rtual ~Date( ) ; 

// Operators. 

// Assignment operator 

Date operator=( const Date& date ); 

// Conversion to Julian date 

operator 1 ong( ) ; 

// Conversion to a string 

operator const char *(); 



// Accessors 

int Month () I 

int DayOfMonthO 
_day_of_month ; ) ; 

int DayOfWeekO 
_day_of_week ; ) ; 

i nt Year( ) ( return 

const char *AsString() 
_stri ng_date . c_str ( ) ; ); 

DateFormat FormatO ( return 



return _month; 
{ return 

return 



year ; ) ; 
return 



format ; 



voi d setMonth ( int m ) ; 

void setDayOf Month ( int _day_of_month ); 

voi d setYear( int y ) ; 

void setFormat( const DateFormat& f ); 

// Operations 
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// Is a given year a leap year? 
bool isLeapYeard'nt year) const; 
// Is this date a leap year? 

void) const; 
mber of days in a given 



int numDaysInMonth( int month, int year 
) ; 

// Return the number of days in the cur- 
rent month, 
int numDaysInMontht void ); 

// Some useful operators for manipula- 
ti on 

Date operator+( i nt numDays); 
Date operator+=( i nt numDays); 
Date operator- ( i nt numDays); 
Date operator-=( i nt numDays); 



#endif 



3. Save your code in the code editor and close the 
file. 

The file you just created is the header and inter- 
face file for the class. This is what the "public" 
will see when they want to use our class. Our 
next task, therefore, is to implement the function- 
ality of the class itself. 

4. In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the Date class. 

In this example, the file is named ch27 . cpp, 
although you can use whatever you choose. 

5. Type the code from Listing 27-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. Change the 
names of the constants and variables as you 
choose. 

These are all the constants and definitions we 
will use for our class. The next step is to add the 
actual implementation. 



Listing 27-2: The Date Class Source File 



//include "ch27.h" 

// Some information we need, 
const char *MonthNames[] = { 

"January" , 

" Februa ry " , 

"March" , 

" Apri 1 " , 

"May" , 

"June" , 

"July" , 

"August" , 

"September" , 

"October" , 

"November" , 

" December" 



int MonthDays[] = 

{ 

31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 



(continued) 
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Listing 27-2 (continued) 



char *DayNames[] 
■Sunday" , 




Wednesday" 
Thursday" , 
Fri day " , 
Saturday" 



#define 0CT5_1582 
#define 0CT14_1582 
#define JAN1_1 



(2299160L) 
(2299169L) 
(1721423L) 



// "really" 15-0ct-1582 
// "really" 4-0ct-1582 



#define YEAR 
#define FOUR_YEARS 
#define CENTURY 
#define FOUR_CENTURI ES 



(365) 

(1461) 
(36524L) 

(146097L) 



static i n t 



DaysSoFar[][13] 



(0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365} , 
(0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366} 



Implementing the bate 
Functionality 

After we have the class defined, it is time to imple- 
ment the actual functionality for that class. In this 



case, we want to add all of the logic for manipulating 
and defining dates. Let's do that now. 

f m Reopen the Date class source file (which we 
called ch27 . cpp). Add the code from Listing 
27-3 to the file. 



Listing 27-3: The Date Functionality 

void Date::Copy( const Date& aCopy ) 
{ 

_julian = aCopy ._j ul i an ; 
_month = aCopy ._month ; 
_day_oT_month = aCopy ._day_oT_month ; 
_day_oT_week = aCopy ._day_oT_week ; 
_year = aCopy._year; 
_Tormat = aCopy ._Tormat ; 
_string_date = aCopy ._stri ng_date ; 



voi d Date : : Ini t( ) 



1 
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_j ul i an = 0 ; 
jnonth = 1; 
of_mo|tJ; 




.format = MMDDYYYY; 

_stri ng_date = AsStringO; 



int Date : : DayOfWeek( int m, int d , int y) 

{ 

_day_of_week = ((_j Lilian + 2) % 7 + 1); 
return day_of_week; 



bool Date: : IsVal idd'nt m, int d, int y) 

{ 

// Check the year. 

if ( y < 0 | | y > MaxYear ) 

return false; 
// Do the month, 
if ( m < 1 | | m > MaxMonths ) 

return false; 

// Finally, do the day of the month. First, the easy check, 
if ( d < 1 | | d > 31 ) 

return false; 
// Now, check the days per fHIS month, 
int daysPerMonth = MonthDays[ m ]; 
if ( isLeapYear( y ) ) 

if ( m == 2 ) 

daysPerMonth ++; 
if ( d > daysPerMonth ) 

return false; 

// Looks good, 
return true; 



1 ong Date : : f oJul i an ( ) 

{ 

int a ; 

int work_yea r=_yea r ; 

long j; 
int 1 p ; 



// Correct for negative year (-1 = 1BC = year 0). 

if (work_year < 0) 

work_year++; 



1 p = ! (work_year & 3) ; 



// Ip = 



1 if this is a leap year. 



(continued) 
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Listing 27-3 (continued) 
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) / 4) + 
[_month-l] + 
_day_of_month + 
(work_year * 365L) + 
JAN1_1 + 
-366; 

// Deal with Gregorian calendar 
if (j >= 0CT14_1582) 



// Plus ALL 1 eap years . 

// Days in years 
// adjustments 



a = ( i nt ) (work_yea r/100) ; 
j = j+ 2 - a + a/4; 



// Skip days that didn't exist. 



_jul ian = j ; 
return _ j u 1 ian; 



void Date: : FromJul ian( ) 

{ 

long z,y; 
short m,d; 
i n t 1 p ; 

z = _j ul i an+1 ; 
if (z >= 0CT5_1582) 

{ 

z -= JAN1_1; 

z = z + (z/CENfURY) - (z/FOUR_CENfURIES) -2; 
z += JAN1_1; 



z = z - ((z-YEAR) / FOUR_YEARS); 
y = z / YEAR; 



// Remove leap years before the current year. 



d = (short) (z - (y * YEAR)); 



y = y - 4712; 
if (y < 1) 

y--: 

lp = !(y & 3): 
if (d==0) 



// This is our base year in 4713 B.C. 



// lp = 1 if this is a leap year. 



y--: 

d = (short) (YEAR + lp); 
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(short) (d/30); // This is a guess at the month, 

while ( DaysSoFar[l p] [m] >=d) 
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// Correct guess. 
- DaysSoFar[l p] [m] ) ; 



_day_of_month = d; 
_month = (short) (m+1); 
if ( _month > 12 ) 
{ 

_month = 1; 
y ++; 

1 

_year = (short) y; 

_day_of_week = DayOfWeek( _month, _day_of_month , _year ) 



Date: :Date( ) 
f 

Init( ) ; 
ToStri ng( ) ; 

} 



Date::Date( int m, int d, int y ) 
{ 

Init( ) ; 

if ( IsValidt m, d, y ) ) 

{ 

_day_of_month = d; 
_month = m; 
_year = y; 
_jul i an = ToJul i an ( ) ; 
ToStri ng( ) ; 

_day_of_week = DayOfWeek( _month, _day_of_month , _year ); 

} 




Date::Date( const Date& aCopy ) 
{ 

Init( ) ; 

Copy ( aCopy ) ; 

} 

Date::Date( long Julian ) 
{ 

Init( ) ; 

_julian = Julian; 
FromJul i an ( ) ; 
ToStri ng( ) ; 

} 



(continued) 
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Listing 27-3 (continued) 

Date: :~Date() 

DropBooks 

Date Date: :operator=( const Date& date ) 

{ 

Copy ( date ) ; 
return *this; 

} 

// Conversion to Julian date 
Date : : operator 1 ong( ) 

{ 

return _j ul i an ; 

} 

// Conversion to a string 
Date :: operator const char *() 

{ 

return _string_date.c_str( ) ; 

} 

void Date : : setMonth ( int m ) 

< 

if ( m < 0 | | m > MaxMonths ) 

return ; 
_month = m; 



void Date : : setDayOfMonth ( int d ) 

{ 

if ( d < 1 | | d > 31 ) 
return ; 

// Now check the days per THIS month, 
int daysPerMonth = MonthDays[ _month ]; 
if ( isLeapYear( _year ) ) 

if ( _month == 2 ) 
daysPerMonth ++; 
if ( d > daysPerMonth ) 

return ; 

_day_of_month = d; 

} 

void Date: : setYeart int y ) 

{ 

if ( y < 0 | | y > MaxYear ) 
return ; 



_year = y; 

} 
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void Date: :setFormat( const DateFormat& f ) 
{ 

_format = f; 
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r( void ) const 



i 

return ( (_year >= 1582) ? 

(_year % 4 == 0 && _year % 100 != 0 | | _year % 400 == 0 ) 
(_year % 4 == 0) ) ; 

} 

bool Date : : i s LeapYear ( int year ) const 
{ 

return ( (year >= 1582) ? 

(year % 4 == 0 && year % 100 != 0 | | year % 400 == 0 ) : 
(year % 4 == 0) ) ; 



// Return the number of days in a given month, 
int Date: :numDaysInMonth( int m, int y ) 
{ 

// Val i date the input . 

// Check the year. 

if ( y < 0 | | y > MaxYear ) 

return -1; 
// Do the month, 
if ( m < 1 | | m > MaxMonths ) 

return -1; 

int daysPerMonth = MonthDays[ m ]; 
if ( isLeapYear( y ) ) 
if ( m == 2 ) 

daysPerMonth ++; 

return daysPerMonth; 



// Return the number of days in the current month. 

int Date: :numDaysInMonth( void ) 

{ 

int daysPerMonth = MonthDays[ _month ]; 
if ( isLeapYear( _year ) ) 
if ( _month == 2 ) 
daysPerMonth ++; 

return daysPerMonth; 

} 

Date Date : : operator+( i nt numDays) 



(continued) 
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Listing 27-3 (continued) 

1 ong j = _ j u 1 nan; 
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Date Date: :operator+=(int numDays) 
{ 

_j ul i an += numDays ; 
FromJul i an ( ) ; 
ToStri ng ( ) ; 
return *this; 

} 

Date Date :: operator- ( i nt numDays) 

{ 

1 ong j = _j ul i an ; 
j -= numDays; 
Date d(j); 
return d ; 

} 

Date Date: : operator-=( i nt numDays) 
( 

_julian -= numDays; 
FromJul i an ( ) ; 
ToStri ng( ) ; 
return *this; 

} 

const char *Date: :ToString( ) 

{ 

char szBuffer[ 256 ] ; 

switch ( _format ) 

{ 

case MMDDYYYY: 

spri ntf ( szBuf f er , "%02d/%02d/%02d" , _month, _day_of_month , _year ); 
brea k ; 
case DDMMYYYY: 

sprintf (szBuffer, "%02d/M2d/%02d" , _day_of_month , _month, _year ); 
brea k ; 
case YYYYMMDD: 

spri ntf ( szBuffer , "%02d/%02d/%02d" , _year, _month, _day_of_month ); 
brea k ; 
defaul t: 

sprintf (szBuffer, "%02d/%02d/%02d" , _month, _day_of_month , _year ); 
brea k ; 

} 

_string_date = szBuffer; 
return _string_date.c_str( ) ; 

} 




Testing the bate Class 



Now, this is a lot of code to deal with. Not to 
worry — the code breaks down into three sepa- 
rate pieces: 




tiilfealil* cWe (shown at -> 1) either 
sefsor^gets oulnndividual member variables 
and initializes them to reasonable defaults. 

► Validation code (shown at -* 2) checks to see 
whether or not the input data is reasonable, 
given the rules and the current settings. 



► Algorithmic code (shown at -* 3 and - 
does the actual date manipulation and 
calculations. 



4) 



2. Save the source-code file and close the code 
editor. 



Always break your classes into discrete initial- 
ization, validation, and calculation pieces. This 
saves you time by focusing your efforts on 
what needs to be done, rather than worrying 
about how to do it. 




Listing 27-4: The Date Test Driver Code. 



3. Compile the test code to make sure that you have 
all of the code properly entered and correct. 



Testing the bate Class 

As with any other utility class, after you have the code 
written for the class, you must be able to provide a 
test driver for that class. The following steps show you 
how to create a test driver that illustrates that the 
code is working properly — and shows other program- 
mers how to use the class in their own applications. 

f m In the code editor of your choice, create a new 
file to hold the code for the test driver. 

In this example, the file is named ch27 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 27-4 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. Change the 
names of the constants and variables as you 
choose. 



#incl 
#incl 



ude 
ude 



<stdi o . h> 
"date . h " 



void DumpDate( Date& d ) 

{ 

pri ntf ( "Date : \n " ) ; 

printf("As String: %s\n", d.AsStringO ); 
printf( "Month: %d\n", d.MonthO ); 
printfC'Day : %d\n", d . DayOfMonth ( ) ); 
printfC'Day of Week: %d\n", d . DayOfWeek( ) ); 
pri ntf ( "Year : %d\n", d.YearO ); 

printf("Leap Year: %s\n", d . i sLeapYea r ( ) ? "Yes" : "No" ); 

pri ntf ( "Number of days in this month: %d\n", d.numDaysInMonth( ) ); 



i nt mai n ( ) 



// Initialized date to no values. 
Date dl; 



(continued) 
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Listing 27-4 (continued) 



II Initialize to the end of the year to test edge cases, 
.te d2(12,|31 ,2004) ; 



— N -tote d2(12 ,|31 ,200 

DropBaoRs 
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dates as strings for testing. 
printf("Dl as string: %s\n", dl . AsStri ng( ) ); 
printf("D2 as string: %s\n", d2.AsString( ) ); 

// fest year wrap and the operator +=. 
d2 += 1; 

printf("D2 as string: %s\n", d2.AsString( ) ); 

// fest backward year wrap and the operator -=. 
d2 - = 1; 

printf("D2 as string: %s\n", d2.AsString( ) ); 

// fest the assignment operator. 
Date d3 = d2; 

// Check to see whether the class works properly for 
// assigned objects. 
d3 - = 10; 

printf("D3 as string: %s\n", d3.AsString( ) ); 

// Validate the day of the week. 
Date d4 (7,27,2004) ; 

printf("D4, day of week = M\n", d4. Day0fweek( ) ); 



// fest the pieces of the date. 
Date d5; 

d5.setMonth( 11 ); 
d5.setDay0fMonth( 31 ); 
d5.setYear( 2004 ); 
d5.setFormat( YYYYMMDD ); 

DumpDatet d5 ) ; 

return 0; 



3. Save the code as a file in your editor and close 
the code editor. 

4. Compile and run the application. 

If you have done everything properly and the code is 
working correctly, you should see output that looks 
like this: 



$ . /a . exe 

Dl as string: 01/01/2004 
D2 as string: 12/31/2004 
D2 as string: 01/01/2005 
D2 as string: 12/31/2004 
D3 as string: 12/21/2004 
D4, day of week = 3 
Date: 

As String: 2004/12/31 
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Month: 12 



Day 



31 



Day of Week: 0 
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s month: 31 



There are some important things to take away from 
this output. First, look at the line marked -* 5 in the 
output listing. This line is output for the date object 
which is defined with the void constructor. As you 
can see, the object is properly initialized with a valid 
date. Next, let's look at the line marked with -* 6. 
This line is output after we added one day to the 
12/31/2004 date. Obviously, this forces the date to 
wrap to the next year, which we can verify by looking 
at the output, showing 01/01/2005. We can also 
verify, by looking at a calendar, that the date shown at 
-* 7 really does fall on a Tuesday (the 3 in the 
output). Finally, we run some simple tests to verify 
that the number of days in the month is correct for 
December, that the pieces of the date are parsed 
properly, and that the leap year calculation is correct. 

All of this output data allows us to validate that our 
class works properly and that the functionality can 
easily be moved from project to project. This will 
save us a lot of time, and allow us to design our pro- 
grams with the date functionality already built. 



Some Finat Thoughts 
on the Bate Class 

As you can see, our Date class is really very useful. 
However, it could easily be made more useful. For 
example, you could allow the user to pass in a string 
to be parsed into its date components, thus solving 
a common programming problem. Another possible 
enhancement would be to initialize the default con- 
structor to be the current date. Finally, it would be 
nice to have the date strings, such as the month and 
day names, within the class itself and accessible. 
This would protect them from access by program- 
mers from outside the class. In addition, it could 
allow us to read them from a file, or get them from 
some internal resource, to provide internationaliza- 
tion without forcing the end user to know where the 
data is stored. 



If you store literal string information in a class, 
make sure that the programmer can replace it 
from outside the class. This will allow the 
developers to put in their own descriptions, 
change the text for internationalization, or just 
modify the text to fit their needs. 




r 



When you are testing a class, make sure that 
you exercise all of the functionality in the ways 
your class is most likely to be used — not just 
the ways that make sense to you at the time. 
Our tests verified that the date math, format- 
ting, and accessor methods all worked properly. 
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Save Time By 




Using factory patterns 


i>* Building a manag 


er class 


V Testing the mana 


ger 


class 





One of the most common "patterns" of software development is the 
factory pattern. It's an approach to developing software that works 
like a factory: You create objects from a single model of a particu- 
lar object type, and the model defines what the objects can do. Generally, 
the way this works is that you create a factory class that allocates, de- 
allocates, and keeps track of a certain base class of objects. This factory 
class really only understands how to manage the object type that forms a 
base for all other objects in the class tree. However, through the magic of 
virtual methods, it is able to manage all of the objects. Let's take a look at 
how this works. By creating a single factory, using virtual methods that 
processes a variety of types of objects, we will save time by not having to 
reimplement this processing each time we need it. 

First, we have a class that manages a given base class of objects — it's 
called a factory. Its uses virtual methods to manage objects — that is, to 
add new objects, remove them, return them to the user, and report on 
which ones are in use and not in use. 

Next, we have a set of derived classes. These override the functionality of 
the base class by using virtual methods to accomplish different tasks. As an 
example, consider the idea of a variety of different kinds of classes to read 
various types of files. We would have a base class, which might be called a 
Fi 1 eProcessor class. Our manager would be a Fi 1 eProcessorManager class. 
The manager would create various FileProcessors, based on the file type 
that was needed, creating them if necessary or returning one that was not 
currently in use. 



QWhen you implement a common base class, set up an object pool to 
manage the objects based on it. That way you can always keep track 
easily of how they are created and destroyed. 



Creating a Factory Class 



In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the factory code. 

In this example, the file is named ch28 . cpp, 
although you can use whatever you choose. 

2, Type the code from Listing 28-1 into your file. 

Better yet, copy the source file from this book's 
companion Web site and change the names of 
the constants and variables as you choose. 



Listing 28-1: The Base-Class Source Code 

#include <stdio.h> 
^include <string> 
^include <vector> 

class Object 

{ 

pri vate : 

std : : stri ng _name ; 
bool _inUse; 

public: 

Object(void) 

_name = "Object" ; 
_i nLlse = fal se ; 

Object( const char *name ) 

_name = name; 
_inUse = false; 

Object( const Objects aCopy ) 

_name = aCopy ._name ; 
_inUse = aCopy ._i nLlse ; 

vi rtual ~0bject( ) 



irtual void MarklnUset bool bFlag ) 

_inUse = bFlag; 
irtual bool InUse( void ) 

return _inUse; 



Creating a Factory Class 



Drd 




aging and processing 
ry class that works with a 
following steps show you 
how to create such a class that utilizes virtual meth- 
ods to create, add, and delete objects. In this case, 
we create a base class called Object from which all 
of our managed objects will be derived. 




(continued) 



Technique 28: Overriding Functionality With Virtual Methods 



Listing 28-1 (continued) 

virtual const char *Name(void) 



virtual void ReportO = 0; 

); 

class MyObjectl : public Object 
{ 

publ i c : 

MyObjectl ( ) 

: Object ("MyObjectl") 

{ 
) 

vi rtual voi d Report( ) 
{ 

printfC'I am a MyObjectl 0bject\n"); 



class MyObjectl : public Object 
{ 

publ i c : 

My0bject2( ) 

: Object ("My0bject2" ) 

{ 
) 

vi rtual voi d Report( ) 
{ 

printfC'I am a MyObjectZ Object\n"); 

) 



class My0bject3 : public Object 
{ 

publ i c : 

My0bject3( ) 

: Object ("My0bject3" ) 

{ 
) 

vi rtual voi d Report( ) 
{ 

printfC'I am a My0bject3 Object\n"); 

) 



class Factory 
{ 

pri vate : 

std::vector< Object *> _objects; 
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publ i c : 

Factory ( ) 




6llp4f\f*S an object to the pool 
TnrTnarVolc rH\dd( Object *obj ) 

{ 

obj ->MarkInUse( true ); 

_objects . i nsertt _objects . end ( ) , obj ); 

} 

// Method to retrieve an object not in use 
virtual Object *Get( void ) 

{ 

std::vector< Object *>::iterator iter; 

for ( iter = _objects . begi n ( ) ; iter != _objects . end ( ) ; ++iter 

{ 

if ( (*iter)->InUse( ) == false ) 

( 

pri ntf( " Found one\n"); 

// Mark it in use 
(*iter)->MarkInUse( true ); 
// And give it back 
return (*iter) ; 



// Didn't find one. 
return NULL; 



} 



virtual void Removet Object *obj ) 

I 

std::vector< Object *>::iterator iter; 

for ( iter = _objects . begi n ( ) ; iter != _objects . end ( ) ; ++iter 

{ 

if ( (*iter) == obj ) 

{ 

(*iter)->MarkInUse( false ); 
break; 



1 



vi rtual void Report( ) 

{ 

std::vector< Object *>::iterator iter; 



(continued) 
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Listing 28-1 (continued) 
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for ( iter = _objects . begi n ( ) ; iter != _objects . end ( ) ; ++iter 
er) ->InUse( ) == true ) 
pri ntf( "Object at %lx in use\n", (*iter) ); 

} 

else 

{ ^ ^^^^^^^^ 
pri ntf( "Object at %lx NOT in use\n", (*iter) ); 

1 

(*iter)->Report( ) ; 



3. Save the file to disk and close the code editor. 

4. Compile the application on the operating system 
of your choice, using your chosen compiler. 

Always implement a method that can report on 
the state of an object of each class. This allows 
you to do quick memory dumps at any time, 
via the factory for each base class. This class can 
be used by a factory class to report status, and 
can be overridden via virtual methods to 
extend that status reporting for derived classes. 



2, Type the code from Listing 28-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site and change the 
names of the constants and variables as you 
choose. 

Listing 28-2: The Test Driver for the Factory Object 

i nt mai n ( ) 

{ 

// Implement an object factory object 
Factory f; 




Testing the Factory 

After you create a class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 
The following steps show you how to create a simple 
test driver to illustrate how the factory class inter- 
acts with the derived objects via virtual methods. 

f m In the code editor of your choice, open the 
source file to hold the code for the test driver. 

In this example, the file is named ch28 . cpp, 
although you can use whatever you choose. 



// Add some objects to the factory 
MyObjectl *objl = new MyObjectl; 



new My0bject2 
new My0bject3 



My0bject2 *obj2 
My0bject3 *obj3 

f.Add( objl ); 
f.Add( obj2 ); 
f.Add( obj3 ); 



// Remove one to simulate the destruc- 
tion of an object 
f . Remove( objl ) ; 

// Now try to get a new one back. 
Object *pObject = f .Get( ) ; 
printfC'I got back a %s object\n", 
pObject->Name( ) ); 
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II Generate a report to see what is in 
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3. Save the file and close the code editor. 

4. Compile the entire program and run it in the 
operating system of your choice. 

You should see the following output if you have 
done everything right. Note that depending on 
your operating system and hardware, the actual 
numbers shown for addresses will vary. 

$ ./a.exe 
Found one 

I got back a MyObjectl object 
Object at a050230 in use 
I am a MyObjectl Object 
Object at a050008 in use 
I am a My0bject2 Object 
Object at a050638 in use 
I am a My0bject3 Object 

This output shows us that the manager is keeping 
track of our various base Object-derived classes and 
creating them only when necessary. As you can see, 
the virtual methods permit us to create the proper 
type for this particular derived class and to create 
them as needed. 

As you can see, the factory manager can handle all 
sorts of different kinds of objects — as long as they 
are derived from a common base class. In addition, 
our virtual methods can be used to differentiate the 
objects to let other programmers know what we 
can do. 



Enhancing the Manager Class 

One way you might consider enhancing the manager 
class is to extend it by letting it allocate its own 
objects. As the code stands, the manager manages 
only the objects that are added to its list. It cannot 
create new ones as they are needed. If all of the 
allocations were done in one place, tracking down 
problems with memory leaks, allocation errors, and 
usage patterns would be vastly simpler. This could 
be done in a variety of ways, from registering a 
"constructor" function that would be passed to the 
manager, to adding code to create specific forms of 
the objects. The latter case is easier, the former case 
more extensible and flexible. 

If you want another bit of programming fun, you can 
add another good feature to add to the manager: 
Implement a method that would delete all objects in 
the class, notifying the objects if necessary. This 
"clean" method could be called at program shut- 
down, in order to guarantee that there are no mem- 
ory leaks in the application. In addition, you could 
use the Report method (shown in Listing 28-1 at 1) 
at various times in your application to ensure that 
you are not leaving orphan objects in the system 
that are not eventually de-allocated. 



There is one other way to implement a man- 
ager, which is worth a mention. You can create 
a manager that is a friend class to all of the 
classes it needs to manage. If you use this 
technique, you should create a method within 
the managed class that knows how to "clone" 
itself. This would essentially be a method that 
allocated a new object, called its copy construc- 
tor with itself as an argument, and returned the 
newly created object to the manager. With this 
technique, the manager doesn't need to worry 
about how to create objects; all it has to do is 
find the ones it manages in its list. 
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Using Mix-In 
Classes 



Save Time By 

i>* Understanding mix-in 
classes 

Implementing mix-in 
classes 

V Testing your code 



Inheritance is an extremely powerful technique in C++. The problem 
with inheritance, however, is that you must either give the end-user 
access to all public methods of a class — or override them privately to 
"hide" them from use by the end-user. C++ takes an all-or-nothing 
approach to the derivation of classes with inheritance. This approach is 
hardly an optimal technique, because removing the undesired functional- 
ity from a class that contains many methods would require more work 
than recreating the class from scratch. For example, if you are inheriting 
from a class that contains a pri nt method, and you do not want that 
method exposed to the end-user, you must hide the method by creating a 
new, private version of it. This is not too difficult when there is only one 
such method, but when there are a dozen of them, it makes more sense 
to create a new class. 



Fortunately, C++ provides an alternative: the mix-in class. Here's how it 
works: The easiest way to limit the functionality you provide from a base 
class is to use that class as a data member of the inherited class — and 
to give the end-user access only to the methods you want them to use, 
instead of providing all methods and removing the ones you don't want 
used. This approach is particularly useful when you have small classes 
you want to initialize and restrict (so that only you have access to them), 
or classes whose overall functionality is more than you feel comfortable 
providing (or is too complicated for the end-user to deal with). The 
embedded base class is a mix-in to the inherited class. 



Mix-in classes are implemented as data members of the class that pro- 
vides the overall functionality and are used to extend that functionality. 
The advantages of the mix-in technique are obvious: It gives the user 
access to the capabilities you want used, you can restrict what the users 
have access to, and you can simplify the methods provided by providing 
your own wrappers with defaults. When your mix-in class is embedded in 
a class the user may instantiate, you control what methods in the mix-in 
class are available. To do this, you simply write accessor methods that 



Implementing Mix-In Classes 




allow the end-user access to the methods you want 
them to be using in the mix-in class. This has several 
advanta££ s. First, ypu control what access the user 

d, if you change the way in 
n class works, the end- 
us'er is not impacted. Finally, you can adapt the func- 
tionality of the mix-in class to your specific needs, 
tailoring its behavior within your wrapper methods. 
Because you do not have to write the entire func- 
tionality provided by the mix-in, you save a lot of 
time, and the usesr get a fully debugged system, sav- 
ing them time. 



V 



Provide access to selected functionality in a class 
by using that class as a mix-in. You can easily 
extend your own classes and move information- 
specific data into a class that handles that data 
only. This is particularly important when work- 
ing with classes that encapsulate data that 
would be easily destroyed, corrupted, or over- 
written if you provided direct access to the data 
members. 



Implementing M/K-ln Classes 

Assume you want to add the ability to save data in 
one of your classes. You could add a base class 
called Save that permits data to be written to a file. 
This class would do all the work of managing the 
output file, writing to it, and closing it. Then you 
could create a mix-in class to do the save functional- 
ity, and then illustrate how that functionality is used 
in a derived class. 

To implement a mix-in class, you simply do the fol- 
lowing steps in your own existing class: 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch29 . cpp, 
although you can use whatever you choose. 



2. Type the code from Listing 29-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 29-1: The Mix-In Class 

#include <stdio.h> 
^include <string> 



class Save 
{ 

FILE *fp; 



publ i c : 

Save( void ) 






fp = NULL; 






Savet const char 


*strFi 


leName ) 


fp = fopen( strFileN 


ame, "w" 


virtual ~Save() 






if ( fp ) 

fcl ose(fp) ; 






void Writet const 


char 


*strOut ) 


if ( fp ) 

fprintf (fp, 


"%s\n 


", strOut 


void Writet i n t i 


) 




if ( fp ) 

fprintf (fp, 


"%d\n 


", i ); 


void Writet doubl 


e d ) 




if ( fp ) 

fprintf (fp, 


"%ld\n", d); 


FILE *getFilePointer() 




return fp; 







(continued) 
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Listing 29-1 (continued) 



class MyClass 
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■'pub! i c : 



MyClasst void ) 
: sCtest.txt") 

s . Wri te( "Sta rt of MyClass"); 

MyClass( const char *strFileName ) 
: s ( st r Fi 1 eName) 

s . Wri te( "Sta rt of MyClass"); 
i rtual -My C 1 ass ( ) 

s . Wri te( " End of My Class"); 
oid Log( const char *strLog ) 

s . Wri te( strLog ) ; 



4 
5 



}; 



int mainCint argc, char **argv) 

{ 

MyClass mc ; 

for ( int i=0; i<argc; ++i ) 
mc. Log( argv[i ] ) ; 
return 0; 



In the above listing, the Save functionality is 
implemented in a mix-in class, which is used by 
the My CI ass class to give the end-user the ability 
to save data from the My CI ass member variables. 
Note that the end-user has no access to the Save 
functionality directly, but instead uses it through 
the Log method, which utilizes the save functions 
but does not directly expose them. 

3. Save the source file in your code editor and 
close the code editor. 



Compiling and Testing 
\lour Mix4n Class 

Let's verify that the code works as illustrated and 
allows you to save data within the MyCl ass objects. 
To do this, we will compile and run the program and 
view the output. The following steps show you how: 

Compile the source code with the compiler of 
your choice on the operating system of your 
choice. 

Note that we have implemented all of the file 
handling functionality — the open (shown at -* 1), 
close (shown at -* 2), and save functions of the 
file — in the mix-in class Save. This class deals 
with all the operating-system-specific work of 
dealing with file pointers. Our main class in the 
example, MyClass, simply works with the mix-in 
class and assumes that it knows what to do for 
various combinations of operating systems and 
environments. 

Always move all operating-system-specific 
functionality for file systems, memory han- 
dling, time functions, and the like, into mix-in 
classes that you can embed in your code. 
Doing so ensures that the code is easily 
portable between different operating systems, 
compilers, and environments. 

2. Run the program in the operating system shell 
of your choice. 

If you have done everything properly, you should get 
no output from the program itself. Instead, you see a 
file which we defined in the My CI ass class at -* 4 
(called test . txt) generated in the file system, resid- 
ing in the directory in which you ran the program. 
This file should contain the output shown in Listing 
29-2. 
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Listing 29-2: The Test.txt Output File 



Start of MyClass 
./ 
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As you can see from the output, the program logs 
some data of its own, indicating the beginning and 
end of the class lifespan. In addition, it allows the 
user to output the arguments to the program. 



Because we did not provide any arguments, it simply 
outputs the name of the executable file, which is the 
first argument to all programs. 

Notice that our class logs its own actions (see -> 5 
and -* 6, these are shown in the output file at -> 7 
and -* 8) as well as the actions of the class it is 
called from. This handy characteristic provides you 
with an essential debugging log from which you can 
look at how the program is operating. 
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The 5 th Wave 



By Rich Tennant 




Real Programmers code in pen. 
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Creating a Simple 
Template Class 



Because our classes can be reused over and over again in C++, we 
want to create as general a class as we can so it can be used in the 
broadest possible variety of applications. For example, it doesn't 
make much sense to create a class that can print out copyright informa- 
tion for only a specific company, such as 

(c) Copyright 2004 MySoftwareCompany Inc. 

It would make a lot more sense to create a class that printed out a copy- 
right symbol, added the company name from an initialization file, and 
then added the year from passed-in arguments (or from the current year 
as specified by the computer clock). Allowing data to be inserted from 
external sources makes the class more generic, which in turn makes it 
more usable across different applications. 

This is the very heart of the C++ construct known as templates. A tem- 
plate is, as its name implies, something that can be customized for spe- 
cific forms of data. For example, consider a class that handled pointers to 
given data types. The class would have the data type hard-coded into it, 
and handle only that particular type of pointer. This class would be use- 
ful if it handled a specific data type, such as a class named Foo. However, 
the class would be even more useful if it handled all the various data 
types that can be assigned to pointers. In C, we handled heterogeneous 
arrays of pointers by using void pointers, which were pointers to blocks 
of memory that did not know what kind of structure, data type, or class 
the block was meant to be. Unfortunately, with C++, void pointers are 
ineffective. For example, consider the code in Listing 30-1: 
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Listing 30-1: Working with Void Pointers 

#include <stdio.h> 



|— ^ # inside <strir|j.h> 

LJropoQoRs 



d *obj ) 



if ( obj ) 
delete obj 



class Foo 

{ 

char *s 
publ i c : 



Foot const cl 

{ 


lar *strTemp ) 




p r i n t f ( " C ( 
s = new d 
strcpy ( s , 

} 


instructor for foo\n"); 
la r [strl en ( strTemp )+l ] ; 
strTemp) ; 




virtual ~Fooi 


: ) 




{ 

pri ntf ( " Dt 
delete s; 

I 

) ; 


:structor for foo\n"); 




int mainO 






{ 

Foo *f = nev 
f unc ( f ) ; 

I 


<i Foo( "T hi s is a test" ) ; 


1 







The above listing illustrates how a pointer can be 
treated as "generic" — that is, having no type. In the 
main program (shown at -* 1), we create a new Foo 
object using the standard constructor for the class. 
This pointer is then passed to the f unc function, 
which deletes the pointer, without knowing what 
type it is. If the destructor for the class were called, 
we would see two output lines, one for the construc- 
tion of the class and one for the destruction. 

If you were to compile this program and run it, you 
would see output that said: 



with no corresponding destructor call for the object. 
Why? Because at run-time, the program does not 
"know" what sort of object obj is in the del ete_f unc 
function, and therefore cannot call the destructor for 
the object. In order for the function to "know" what 
the object it receives is, we must pass it by type. If 
we are writing a manager of pointers, it would cer- 
tainly be useful to know what the data types were, so 
that we could destroy them properly. In order to 
avoid the problem of void pointers, we could simply 
derive all objects from a common base type, such as 
an Object type and then call that destructor for all 
objects. The problem with this is that it not only 
introduces overhead in creating the objects, and 
requires extra space for the base class, it creates 
problems with multiple inheritance. (For more on 
multiple inheritance, see Technique 22.) There is 
really no reason to introduce extra complications 
when there are simpler approaches possible, and 
the simpler approach, in this case, is to use C++ t 
emplates. Templates will save you time and effort 
by reducing the amount of code written and general- 
izing solutions that can be used across multiple 
projects. 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch30 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 30-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 30-2: The Template Approach 

#include <stdio.h> 
#include <string.h> 
#include <vector> 

template <class A> 
class Manager 



Constructor for foo 
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std : : vector< A *> _objects; -> 7 




~Manager( ) 
{ 

CI ean ( ) ; 

} 

void Addlnstancet A *pObj ) 

{ 

_objects . i nsert ( _objects . end ( ) , pObj 

) ; 

} 

void CleanU 

{ 

std::vector< A *>::iterator iter; 
for ( iter = _objects . begi n( ) ; iter != 
_objects . end( ) ; ++iter ) 
{ 

delete (*iter); 

} 

_objects . cl ear ( ) ; 

} 

A *NewInstance( ) 

{ 

A *pObject = new A; 
Addlnstance(pObject) ; 
return pObject; 

} 

void Del etelnstancet A *obj) 

{ 

std::vector< A *>::iterator iter; 
for ( iter = _objects . begi n ( ) ; iter != 
_objects . end( ) ; ++iter ) 

if ( (*iter) == obi ) 
_objects . erase ( i ter ) ; 
delete obi ; 

} 



class Foo 

{ 

char *s; 
publ i c : 

Foo (void) 

{ 

pri ntf( "Constructor for foo\n"); 
const char *strTemp = "Hello world"; 



s = new char[strl en(strTemp)+l] ; 
strcpy ( s , strTemp) ; 

Foot const char *strTemp ) 

pri ntf( "Constructor for foo\n"); 
s = new char[strl en(strTemp)+l] ; 
strcpy (s , strTemp) ; 

Foot const Foo& aCopy ) 

s = new char [strl en ( aCopy . s )+l] ; 
strcpy ( s , aCopy . s ) ; 

virtual ~Foo() 

pri ntf( "Destructor for foo\n"); 
delete s; 

const char *String() 

return s; 

void setStringt const char *str ) 

if ( s ) 

delete [] s; 
s = new char[strl en(str)+l] ; 
strcpy ( s, str ); 



int main (void) 
{ 

Manager<Foo> manager; -* 6 

Foo *f = manager . Newlnstancet ) ; -* 2 

Foo *fl = manager. Newlnstancet ) ; 

Foo *f2 = manager. Newlnstancet ) ; 

Foo *f3 = manager . Newlnstancet ) ; 

manager . Del etelnstance ( f ); -* 4 

manager . Cl ean ( ) ; 

return 0; 



3, Save the source file in your code editor and 
close the code editor. 
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4. Compile the source code with the compiler of 
your choice on the operating system of your 
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done everything nrope 



lotf Ik J |yh>l r VigT^rogram is run, if you have 
done everything properly, you should see the 
following output in the shell window: 

$ ./a.exe 

Constructor for foo -» 3 

Constructor for foo 

Constructor for foo 

Constructor for foo 

Destructor for foo 

Destructor for foo 

Destructor for foo 

Destructor for foo 

The output shows us that the constructor is being 
called from Newlnstance (shown at -* 2 and then 
indicated in the output at -* 3), but more impor- 
tantly that the destructor is properly invoked when 
we call the Deletelnstance method of the manager 
(shown at -* 4). 

As you can see, the manager does understand the Foo 
class type, even though we have not actually used 
the Foo name anywhere in the manager definition. 
We know this because the manager properly con- 
structs and deletes the objects. How does it do this? 
Essentially, the tempi ate keyword (shown at -*■ 5 in 
the code listing) does all of the work. When the com- 
piler encounters the tempi ate keyword, it treats the 
entire block (in this case, the entire class definition) 
as if it were a giant "macro" (for lack of a better 
word). Macros, as you might recall from the 'C pre- 
processor, substitute a given string for a specific 



keyword within the block. Everywhere that the entry 
in the template (A, in our example) appears within 
the block, it's replaced with whatever the template 
class is instantiated with (at -> 6). In our main driver, 
you will see the line: 

Manager<Foo> manager; 

This line is expanded by the compiler to replace the 
A with Foo everywhere that it appears in the tem- 
plate definition. Unlike macros, however, checking is 
done at the time the instantiation is created, to 
insure that the code generated is valid C++. For 
example, had we omitted a copy constructor from 
the Foo class, it would have generated an error in the 
use of the Foo class within an STL vector class, 
because all maneuvering in the vector is done by 
copying objects from one place to another. You 
would have seen an error at the line marked -* 7. 
The error would have said something about not find- 
ing a copy constructor for the class, when the tem- 
plate class vector was expanded by the compiler. 
For this reason, the compiler first instantiates the 
entire class, using the class supplied, then compiles 
the result. 



r 

A . 



When you are implementing a template class, 
put all the code inline in a header file. If you 
don't, many compilers will only appear to 
compile the code — but will actually fail in the 
link phase, since the template instantiation is a 
one-phase operation. The compiler will not go 
back and load the code from an external 
source file. 
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After you have created a base class that can be used as a template, 
you can extend that template class by utilizing it in your applica- 
tion. Extending a template class allows the functionality you have 
defined in the template to be utilized in other ways. There are actually 
four ways to utilize a template class in your own code. All of them will 
save you time by allowing you to reuse existing code without having to 
rewrite it, and to gain the expertise of the original template class writer 
for your code. 

You can use the actual template class as a template object in your 
code. To do so, simply use the class with a template argument of your 
own choice. This is the approach when working with container classes 
from the Standard Template Library, for example. 

You can use the class you've identified as a template as a member vari- 
able in your own object. This means embedding an instance of the 
template class with a template argument of your own choice in your 
object. 

To use the template class as a base class for your own object, specify 
the template argument up front and use it to identify the base class. 

You can use the templated class as a base class for your own inherited 
class (either a templated class or a non-templated one), allowing the 
end user to specify one or more template arguments to the class. 

This technique looks at all these options and explores the flexibility and 
power of each one. 
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If you choose to implement templates, be aware that they have a 
high degree of overhead in the code, and they require that all their 
code be available to the end-user. It's best to implement small tem- 
plate classes and provide them in header files for the end-user to use. 
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Implementing Template 
Classes in Code 




|oes no good to simptydiscuss the various ways in 
which you can implement templated classes in your 
code without concrete examples. Let's look at a few of 
the various ways in which we can utilize a templated 
base class in our own applications. Here's how: 

In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch31 . cpp, 
although you can use whatever you choose. 

2, Type the code from Listing 31-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 31-1: Using Templated Classes in Your Code 

#i include <stdio.h> 
#i include <string> 



// The base template name 
template < class A > 
class Base 

{ 

std : : st ri ng _name ; 
A *_pointer; 
publ i c : 

B a s e ( v o i d ) 

{ 

_name = " Nothi ng" ; 
_pointer = NULL; 

I 

Basetconst char *strName, A *aPointer ) 

{ 

_name = strName; 
if ( aPointer ) 

_pointer = new A(aPointer); 
else 

_pointer = NULL; 

I 

Base( const Base& aCopy ) 



printf("Copy constructor called\n"); 

_name = aCopy._name; 

_pointer = new A( aCopy ._poi nter ) ; 

vi rtual ~Base( ) 

del ete _poi nter ; 

*Poi nter( ) 

return _pointer; 

std : : stri ng Name( ) 

return _name; 

void setPointer( A *aPointer ) 

if ( _pointer ) 

del ete _poi nter ; 
^pointer = new A(aPointer); 

void setName( const char *strName ) 

_name = strName; 

void P r i n t ( ) 

pri ntf ( "Base : \n " ) ; 

printfC'Name = %s\n", _name . c_str( ) ) : 
pri ntf (" Poi nter = \n"); 
if ( _pointer ) 

_poi nter->Pri nt( ) ; 
el se 

pri ntf (" Poi nter is NULL\n"); 



class Foo 
I 

pri vate : 

i n t i ; 
publ i c : 

Foo(void) 

{ 

i = 0; 

} 

Foo ( int iNum ) 

{ 

i = iNum; 
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Foo( const Foo& aCopy ) 

ML™ , 

i = aCopy->i ; 

} 

virtual -Foot) 

{ 

} 

int getNumbert void ) 

{ 

return i ; 

} 

void setNumbert int num ) 

{ 

i = num; 

} 

void Print(void) 

{ 

printfC'Foo: i = %d\n", i ); 



// Case 1: Using base template as a member variable 
class Tempi ateAsMember 



Base<Foo> _fooEntry; 
public: 

Tempi ateAsMember (void) 

: _fooEntry( "Tempi ateAsMember" , NULL) 



Tempi ateAsMember ( int intNum ) 

: _fooEntry( "Tempi ateAsMember" , new Foo(intNum)) 



void setNumtint iNum) 

_f ooEntry . Poi nter ( ) ->setNumber ( iNum ); 
nt get Num (void) 

return _fooEntry.Pointer() ->get Number ( ) ; 
nt multiplyd'nt iMult) 

_fooEntry . Poi nter () ->setNumber ( _fooEntry . Poi nter () ->getNumber ( ) * iMult 
void PrintO 



(continued) 
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Listing 31-1 (continued) 



i ntf ( "Tempi ateAsMember\n" ) ; 
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// Case 2: Using the base template as a base 
class 

class Tempi ateAsBase : public Base<Foo> 
I 

publ i c : 

Tempi ateAsBase ( voi d ) 

: Base<Foo>( "Tempi ateAsBase" , NULL ) 



B* getBPointert ) 
{ 

return _anotherPoi nter ; 

} 

void Print O 
{ 

Base<A>: : Printt ) ; 

if ( _anotherPoi nter ) 

_anotherPointer->Print(); 
el se 

pri ntf ( "Another pointer is NULL\n"); 



class AnotherBase 



Tempi ateAsBase(const char *name, Foo 
*pFoo ) 

: Base<Foo>( name, pFoo ) 

{ 
} 

virtual -Tempi ateAsBase( voi d ) 



void P r i n t ( ) 

{ 

pri ntf ( "Tempi ateAsBase : \n" ) ; 
Base<Foo> : : Pri nt( ) ; 



// Case 3: Using the base template as a base 
class 

// for another templated class 

template < class A, class B > 

class Tempi ateAsBaseTempl ate : public Base<A> 

{ 

private: 

B *_anotherPoi nter ; 
publ i c : 

Tempi ateAsBaseTempl ate( void ) 

: Base<Foo>( "Tempi ateAsBaseTempl ate" , 
NULL ) 



pri vate : 
int x; 



publ i c : 

AnotherBaset ) 




X 


= 0; 




AnotherBaset int i ) 




X 


= i ; 




virtual ~AnotherBase(voi 


d) 


voi c 


PrintO 




pri ntf ( "AnotherBase : 

}; 


x = %d\n" , x ) ; 



In Listing 31-1, the code shows how each possible 
case is addressed and used. We have implemented 
two "normal" classes, called Foo and AnotherBase, 
which are used as template arguments to designate 
the template classes. 



_anotherPoi nter = NULL; 

} 

Tempi ateAsBaseTempl ate( A* anA, B* aB ) 
: Base<Foo>( "Tempi ateAsBaseTempl ate" , 
anA ) 

{ 

_anotherPoi nter = aB; 



Testing the Template Classes 

To check whether the code is really working, we 
need to implement a test driver. The following steps 
do so for the code in Listing 31-1: 



Testing the Template Classes 



Drop 



In the code editor of your choice, reopen the 
source file for the code you just created. 

ile is named ch31 . cpp, 
whatever you choose. 

Append the code from Listing 31-2 to your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 31-2: The Test Driver for the Templated Class 
Example 

int mainU 



Creating base 

Void constructor called 
Creating template as member 
Creating base with name 

[Tempi ateAsMember] 
Creating template as base 
Creating base with name [Tempi ateAsBase] 
Creating template as base template 
Creating base with name 

[Tempi ateAsBaseTempl ate] 
Base : 

Name = Nothing 
Pointer = 

Pointer is NULL 1 
Tempi ateAsMember 



{ 






Base : 




printfCCrea 


ti ng base\n" ) ; 




Name = Tempi ateAsMember 




Base<Foo> fc 


oBase ; 




Pointer = 




printf ( "Crea 


ting template 


as member\n" ) ; 


Pointer is NULL 




Tempi ateAsMember tempMem; 




Tempi ateAsBase : 




pri ntf ( "Crea 


ting template 


as base\n" ) ; 


Base : 




Tempi ateAsBa 


se tempBase; 




Name = Tempi ateAsBase 




pri ntf ( "Crea 


ting template 


as base tem- 


Pointer = 




pi ate\n " ) ; 






Pointer is NULL 




Tempi ateAsBa 


seTempl ate<Foo 


, AnotherBase> 


Base : 




tempAsBT ; 






Name = Tempi ateAsBaseTemf 


il ate 








Pointer = 




f ooBase . Pri n 


t(); 




Pointer is NULL 




tempMem. Pri n 


tO; 




Another pointer is NULL 




tempBase .Pri 


nt(); 








tempAsBT .Pri 


nt(); 




The output from this program shows us that each of 


return 0; 

I 






the various template instantiations works. As you 






can see, in each case (see, for example, the line 
marked -* 1), the constructor was called and the 



3. Save the source file in your code editor and 
close the code editor. 

4. Compile the source code with the compiler of 
your choice, on the operating system of your 
choice. 

When the program is run, if you have done every- 
thing properly, you should see the following output 
in the shell window: 



various member variables assigned proper default 
values. Looking at the examples, it should be clear 
that each of the various methods arrives at the same 
conclusion. 



Concrete classes that have been made into 
templates as a specific form of a class are best 
suited for extension. This is to say, if you have 
a template class that accepts a particular type 
of class for its argument, you are better off 
extending your template class by creating a 
form of it as a specific class — and then deriv- 
ing from that specific class. The reason for this 
is more human than technical: People usually 
don't think in terms of templates so much as 
in terms of class names. 
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XopKing at trie four choices in extending base 
classes, you will probably notice a few things that 
suggest particular approaches to the process. 

To utilize methods in a base class being used as a 
template, you must specify which version of the 
class the template is to use. The reason is that you 
could conceivably have a class that inherited from 
multiple classes of the same template, with different 
types associated with it. This is a good thing because 
it allows you to segregate specific functionality into 
separate classes. 

Another thing worth noticing is that you may create 
a templated class that does not require a class as its 
argument. For example, we could create a template 
with a numeric argument; the following steps show 
you how: 

f m In the code editor of your choice, create a new 
file. 

In this example, the file is named ch31a . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 31-3 into your file. 

Listing 31-3: A Template Class with a Non-class 
Argument 

template <class A> 
class LessThanTen 

{ 

A _el ement ; 

publ i c : 

LessThanTent A entry ) 

{ 

set ( entry ) ; 

} 

LessThanTent const LessThanTenS aCopy ) 

{ 

set( aCopy ._el ement ) ; 

} 

void set( A value ) -> 3 



if ( value > 0 && value < 10 ) 
_el ement = value; 

} 

A get() 
{ 

return _element; 



This code works for a class argument, so long as 
that class can be compared to an integer. It can 
also be used for a non-class argument, such as an 
integer, long integer, or even a floating point 
value. 

With this class shown in Listing 31-3, there is no 
reason that the template argument should be a 
class. In fact, it would be implied that a numeric 
element was used, since the value which is 
passed into the set method is compared to an 
integral value of 10 (see the line marked -* 2). 

3. Add the following code to your source file to 
test the integer class. This code will test the 
template class we just defined above. 

int main (void) 
1 

LessThanTen<i nt> ten(3); -* 5 

printfC'The value is %d\n", 

ten . get( ) ) ; 
ten. sett 23 ); 4 
printf("The value is now %d\n", 

ten . get( ) ) ; 
return 0; 



4. Save the source file in your code editor and 
then close the code editor. 

Compile the source code with the compiler of 
your choice, on the operating system of your 
choice. 

When the program is run, if you have done every- 
thing properly, you should see the following output 
in the shell window: 
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$ . /a . exe 

The value is 3 
The value is now 3 




I cgHggls^ijinfAp^yitput, the program indeed 
dies properly create a new class that is a templated 
version of the LessThanTen class, using an integer as 
its template argument. The resulting class contains a 
method called set that takes an integer argument 
(shown at 3) that must be between 0 and 10. Since 
our value (see -» 4) is not within that range, it is not 
assigned, and we see that the print statement fol- 
lowing the assignment still contains the value 3. 



Notice that the code works with an integer argument 
(see the line marked with 5), even though the 
template specifies a class argument. For C++, inte- 
gers, floating-point numbers, and the like can be con- 
sidered first-class (that is, a basic type) arguments 
for the purpose of templates. In fact (in this case at 
least), any argument can be used, so long as the 
code includes comparison operators greater-than 
(>) and less-than (<) to ensure that the set method 
works properly. 

The ability to use either classes or basic types as 
template arguments makes the template construct 
extremely powerful in C++. Because you can write a 
single class that manages number, character strings, 
or class values and have it work seamlessly, you save 
enormous amounts of time and duplicated work. 
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Creating Templates 
from Functions and 
Methods 



Save Time By 

f* Creating function 
templates 

V Creating method 
templates 

V Interpreting your output 



Although creating entire classes that are templates is useful, some- 
times you just want a single function or method to accept a tem- 
plate argument. For example, if you created a comparison function 
that used a template for all types, you could then create (say) a mini mum 
function that would compare any two data types, including classes, as 
long as you could tell one was of lesser magnitude than the other. This 
technique shows how to save time by templatizing only a single function 
(and later, a single method) of a class. 

Implementing Function Templates 

A function template, or method template, is simply a standalone function 
(inside a class, in the case of a method) that can accept one or more tem- 
plate arguments. Let's take a look at how you would implement function 
templates in your own code, by creating a generic function that will com- 
pute the minimum of two values. 

f m In the code editor of your choice, create a new file to hold the code 
for the implementation of the source file. 

In this example, the file is named ch32 . cpp, although you can use 
whatever you choose. 

2. Type the code from Listing 32-1 into your file. 



Better yet, copy the code from the source file on this book's compan- 
ion Web site. 



Implementing Function Templates 



Listing 32-1: The Min Template Function 



#include <stdio.h> 




{ 

if ( vail == val2 ) 

return vail; 

if ( vail < val2 ) 

return vail; 

return val2; 

} 



bool operator==( const std : : stri ng& si, const std::string& s2) 
{ 

i nt 1 en = si . 1 ength ( ) ; 
if ( len != s2.1ength() ) 
return false; 



for ( int i=0; i<len; ++i ) 
if ( sl[i] != s2[i] ) 
return false; 



return true; 

} 



bool operator <(const std::string& si, const std::string& s2 



int len = si . 1 ength ( ) ; 
if ( len > s2.1ength() 
len = s2 . 1 ength ( ) ; 



for ( int i=0; i<len; ++i ) 
if ( sl[i] > s2[i] ) 
return false; 



return true; 

} 



int maind'nt argc, char **argv) 



// First, try it for integers 
int xl = 100; 
int x2 = 30; 

int xmin = my_min(xl, x2); 



// Now, for floating-point numbers 

float fl = 12.40; 

float f2 = 4.90; 

float fmin = my_min(fl, f2); 



(continued) 
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Listing 32-1 (continued) 



int xmin2 = my_min(x2, xl); 
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Mi" , xmi n ) ; 
l\n" , xmi n2 ) ; 
pri ntf ( " Fmi n = %f\n", fmin ); 



// Now that we have implemented the operators, 

// try it for strings. 

std:: string si = "Hello world"; 

std::string s2 = "Goodbye cruel world"; 

if ( si == s2 ) 

pri ntf ( "Stri ngs are equal\n"); 
else 

if C si < s2 ) 

pri ntf(" string %s is less\n", sl.c_str() ); 

else 

pri ntf ( "Stri ng %s is less\n", s2.c_str() ); 
std::string smin = my_min( si, s2 ); 

printfC'Min for strings returned: Xs\n", smin.c_str() ): 



5. Save the source file in your code editor and 
close the code editor. 

Note that we have created a templated function 
called my_mi n, shown at -* 1 (it was not called 
mi n, because that would conflict with a Standard 
Template Library (STL) function of the same 
name), which can be used with any data type 
that supports the equal (=) and less-than (<) 
operators. 

In this case, the source code also implements 
less-than and equal-to operations for the stan- 
dard string class in the STL. After we have imple- 
mented these operators, we can then instantiate 
the template for the string class. 

4. Compile the source code with the compiler of 
your choice on the operating system of your 
choice. 

When the program is run, if you have done every- 
thing properly, you should see the following output 
in the shell window: 



$ . /a . exe 

Xmin = 30 
Xmin2 = 30 
Fmin = 4.900000 

String Goodbye cruel world is less 
Min for strings returned: Goodbye cruel 
worl d 

Let's look at this carefully, and see what is going on. 
We are calling the minimum function, my_mi n, in 
three locations, shown at the lines marked with -> 2, 
-* 3, and -* 4. The first line computes the mi n for 
two integers, the second for two floating point num- 
bers, and the third for two strings. 

Although integers and floating point numbers have 
their own comparison operators (less than, greater 
than, and so forth) built into the language, strings do 
not. Therefore, we implement the comparison func- 
tions that will be called by my_mi n at the lines 
marked -* 5 and -* 6. After all of this is done, the 
compiler generates the proper versions of these 
functions and you see the minimum calculation out- 
put shown above. 
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In this example, the template is automatically 
generated. Unlike a template class, function 
templates don't require the programmer to 
,type that the template is 
for. This saves a lot of 
timeT youdon't have to track down where the 
template was instantiated. The linker is also 
smart enough, with most modern C++ com- 
pilers, to link only in one copy of a given tem- 
plate. This means that if you have multiple 
calls to a specific templated function in your 
program, only one will be in the final exe- 
cutable. If your linker is not that smart, you 
have to force the implementation of a given 
template in your code. 



Listing 32-2: A Class with a Templated Method 

class Foo 
{ 

private: 

std : : stri ng _name ; 

int _value; 
publ i c : 

Foo(void) 
{ 

_name = "Nothi ng" ; 
_value = 0; 

) 

Footconst char *strName, int iValue) 
( 

_name = strName; 
_value = iValue; 



Creating Method Templates 

Similarly, you can also create methods of classes 
that are themselves templates, even though the 
class as a whole might not be. You might want to do 
this as a way to avoid writing a lot of the same code 
over and over, such as creating a set of assignment 
methods for different data types. 



When you find yourself writing the same 
method over and over, but specifying a differ- 
ent data type (such as a set method or an 
assignment operator) for each one, immedi- 
ately think about creating a template method 
for that operation. This can save you a lot of 
time. 



The following steps show you how to create a 
method template: 




Foot const Foo& aCopy ) 
{ 

_name = aCopy ._name ; 
_value = aCopy ._val ue ; 

1 

Foo operator=( const Foo& aCopy ) 
I 

_name = aCopy ._name ; 
_value = aCopy ._val ue ; 
return *this; 

} 

// Templatized method to add values 

template < class A > 

void Add( const A& aValue ) 

{ 

_val ue += aVal ue; 

1 

// Templatized method to multiply values 
template < class A > 

void Multiplyt const A& aValue ) -> 7 

{ 

val ue = val ue * aVal ue; 



/. In the code editor of your choice, reopen the 
source file for the code that you just created. 

In this example, the file is named ch32 . cpp, 
although you can use whatever you choose. 

2. Add the code from Listing 32-2 into your file. 

Or better yet, copy the code from the source file 
on this book's companion Web site. 



// Method to dump the values 

void P r i n t ( ) 

{ 

pri ntf ( "Name : [%s]\n", _name.c_str( ) 

) ; 

pri ntf ( " Val ue : %d\n", _value ); 



(continued) 
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Listing 32-2 (continued) 



int operator*( int iValue, std::string s ) 



Drop Books: 

// nn tho miiltinl if 



'to an integer 
• s . c_str( ) ) ; 
// Do the multiplication 



int i Result = i Value 
// Return it 
return iResult; 



iMul t ; 



The above listing shows a class, Foo, which 
contains a templated method called Multiply 
(shown at -» 7). This method will allow you to 
multiply various types of data and assign the 
result to a member variable within the class. 
Notice also the operator* function that is 
defined even to multiply our value by a string. 

3. Change the main function of the source file to 
be as shown in Listing 32-3: 



if ( si == s2 ) 

pri ntf ( " Stri ngs are equal\n"); 
el se 

if ( si < s2 ) 

pri ntf (" stri ng %s is less\n", 
si . c_str ( ) ) ; 

el se 

pri ntf (" Stri ng %s is less\n", 
s2.c_str() ); 

std:: string smin = my_min( si, s2 ); 
printf("Min for strings returned: %s\n' 
smi n . c_str ( ) ) ; 

Foo f ( "My Foo" , 10) ; 
f.Add( 12.0 ); 
f . Printt ) ; 
f.Multiply( -1 ); 
f . Print( ) ; 

f .Multiply (std: : string ("12")) ; 
f . Print( ) ; 



Listing 32-3: The Test 1 


Driver for the Templated 


Method 


int maind'nt an 

{ 

// First, tr; 


jc , char **argv) 
/ it for integers 





Note that as with template functions, the pro- 
grammer does not in any way create an instance 
of the templated member function. The compiler 
will create instances as needed, by matching up 
int xl = 100; the possible template arguments with the avail- 

int x2 = 30; able templates. Naturally, this will only work if 

int xmin = my_min(xl, x2); the template class definition is available, so once 

again, the template methods must be in-line 
// Now, for floating point numbers defined methods. Because there is no "natural" 

way in which to multiply a string by an integer, 
we define a global operator which accepts an 



float fl = 12.40 
float f2 = 4.90; 
float fmin = my_min(fl, f2) 



int xmin2 = my_min(x2, xl); 



integer value and a string, and returns the con- 
verted string multiplied by the integer. After this 
operator is defined, we can then pass in a string 
pri ntf ("Xmin = M\n", xmin); to the templated method. (If the operator was 

pri ntf ( "Xmi n2 = %d\n", xmin2 ); not defined, you get a compile error when the 

pri ntf(" Fmin = %f\n", fmin ); template is expanded and the integer multiplica- 

tion by the input argument is attempted.) There 
// Now that we have implemented the oper is a quite a bit going on here, obviously. 

// ators, try it for strings. 

std::string si = "Helloworld"; 4. Compile the source code with the compiler of 

std:: string s2 = "Goodbye cruel world"; your choice on the operating system of your 

choice. 
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When the program is run, if you have done every- 
thing properly, you should see the following output 



in the shell window. 




ooks 



30 



Xmin2 = 30 

Fmin = 4.900000 

String Goodbye cruel world 

Min for strings returned: 

worl d 
Name: [MyFoo] 
22 

[MyFoo] 

-22 
[MyFoo] 
-264 



is less 
Goodbye 



Value: 
Name : 
Value: 
Name : 
Value: 



The initial part of our output is from the first part of 
this technique and has not changed. The second 
part, beginning with the line marked 8, shows the 
result of our templated method. As you can see, we 
first assign the member variable value the value 10. 
We then add 12 to it, resulting in the output of 22. 
Now, we start using the Mul ti pi e method. First, we 
multiply by an integer value of -1, resulting in the 
output of -22. Then we multiply by a string value 
of 12, which is converted to an integer using the 
operator* function we defined, which results in 
-264 — the value that is printed out. 

Note that the string is evaluated to its integer value, 
12, and the result multiplied by the current value of 
-22. This results in a total of -264, which is the value 
displayed on the console window. 
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i>* Understanding the 

vector class 
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classes 
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vector class 



The Standard Template Library (STL) provides access to a number of 
different forms of storage classes. One of these is the vector class, 
which allows the programmer to store arbitrary arrays of objects. 
Unfortunately the vector class also requires that you "pull in" (link) 
the entire STL to use it. This can cause significant overhead in your 
application and can consume large amounts of memory. Because the 
vector class is a templated class, it copies large chunks of code each 
time it's used. Although this is normally insignificant for large-scale 
applications — and well worth the expense of memory and size — it can 
be quite costly when your applications are smaller or have to operate in 
more restricted memory areas, as with embedded applications. For this 
reason, it makes sense to get handy with not only the vector class but also 
with implementing your own simple array classes that can use restricted 
memory. This technique shows you how to use vector classes — and 
techniques for working with various algorithms with the vector class. 
The next technique, Technique 34, shows you how to use array classes 
with limited overhead. 



The vector class is amazingly powerful and, after you get the hang of it, 
very easy to use in your own code. Let's look at an example of working with 
vectors. We will examine how to add data to a vector, step through (iterate) 
the values in the array, and print out the data in the array. Here's how: 

/. In the code editor of your choice, create a new file to hold the code 
for the implementation of the source file. 

In this example, the file is named ch33 . cpp, although you can use 
whatever you choose. 

2. Type the code from Listing 33-1 into your file. 
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Better yet, copy the code from the source file on this book's compan- 
ion Web site. 
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Listing 33-1: Working with Vectors 



#i include <stdio.h> 



l_ ^ #i|aJ^de <striig> 
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using namespace std; 

template < class A > 

void print_array( vector<A> array ) 

< 

vector<A> : : i terator iter; 

for ( iter = array .begint ) ; iter != array. end(); ++iter ) 
cout << (*iter) << "\n"; 

} 

void reverse__array ( const vectoKstri ng>& arrayln, vectoKstri ng>& arrayOut 

{ 

vector<stri ng> : : const_i terator iter; 

for ( iter = arrayln. begint ) ; iter != arrayln. end( ) ; ++iter ) 

{ 

arrayOut . i nsert ( arrayOut. begint ) , (*iter) ); 



int maintint argc, char **argv) 

{ 

vectoKstri ng> stringArray; 



// First, add all of the arguments to the 

// array that were passed into the application. 

for ( int i=0; i<argc; ++i ) 

stri ngArray . i nsert ( stri ngArray . end ( ) , argv[i] ); 

// Print them out using an iterator 
vectoKstri ng>: : iterator iter; 

for (iter = stri ngArray . begi n () ; iter != stri ngArray . end () ; 
++iter ) 

{ 

// This isn't necessary, but illustrates how to get 
// the actual item stored in an array element. Note that 
// the copy constructor will be invoked on this line, 
string s = (*iter); 

cout << "Element: " << s << "\n"; 



(continued) 



m Technique 33: Working With Arrays 



Listing 33-1 (continued) 



II Now, we want to remove any element in the array which is the number 
gArray . begi n ( ) ; iter != stri ngArray . end ( ) ; 
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if ( (*iter) == "3" ) 
{ 

cout << "Erasing element " << (*iter) << "\n"; 
stringArray .erase( iter ); 



// Display the results for the user 
pri ntf( "Array after removal\n"); 
print_array( stringArray ); 

// Next, reverse the array 
vectoKstri ng> outArray; 
reverse_array( stringArray, outArray ); 
pri ntf( "Array after reversal \n" ) ; 
print_array( outArray ); 

return 0; 



,3. Save the source file in your code editor and 
close the code editor. 

This source code utilizes the power and function- 
ality of the Standard Template Library to do sim- 
ple array manipulations, including adding new 
data to an array, reversing the elements in an 
array, and iterating over the elements in an array. 

4. Compile the source code with the compiler of 
your choice, on the operating system of your 
choice. 

When the program is run, if you have done every- 
thing properly, you should see the following output 
in the shell window: 



$ ./a 


exe 


El ement : 


./a 


El ement : 


1 


El ement : 


2 


El ement : 


3 



Element: 4 

Erasing element 3 

Array after removal 

./a 

1 

2 

4 

Array after reversal 

4 

2 

1 

./a 

As you can see, the program reads in the arguments 
from the command line, places them into an array 
(shown at the line marked -> 1), then prints out the 
array by iterating over each element and printing 
out the data contained at that array element (shown 
at -> 2). Next, the program removes all values of 3 
from the array, illustrating how you can delete from 
an array (shown at -* 3) and leave the rest of the 
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elements in order. Finally, the values in the array 
are reversed, by copying them into a new array in 
reversa^rder (shown at -»> 4) and the result is 



reversa^der (shown at 

DropBooRs 

Tfiis example illustrates b 



Tfiis example illustrates how easy it is to work with 
the vector class in the C++ STL — and the result is 
very powerful. Unfortunately, the class is also quite 



large. On my system, the resulting executable file 
takes up over 400KB for this simple little program. 
This illustrates how the STL pulls in a lot of code 
when you utilize it. Admittedly, in today's world, 
400 KB is not that large, but it's a lot for such a small 
program. 
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After you have learned how to use the STL vector class (see 
Technique 33), it is very instructive to see how you might imple- 
ment the same sort of class yourself — but with more limited over- 
head. Here's a look at implementing a simple vector class that not only 
stores strings, but can also insert, delete, and iterate. 

Creating the String Array Class 

As we saw in Technique 33, the overhead in using the Standard Template 
Library (STL) is rather high when you want to add only a single array to 
your program. If you are using multiple array classes, you might as well 
use the STL, because that way you only have to pay the price (in terms of 
memory and application size) once. Each array class beyond the first 
uses negligible space in your application. Let's create a simple string 
array class that illustrates how easy it is to create array classes for your 
application that work with specific data types. The following steps show 
you how: 



f. In the code editor of your choice, create a new file to hold the code 
for the implementation of the source file. 

In this example, the file is named ch34 . cpp, although you can use 
whatever you choose. 

2. Type the code from Listing 34-1 into your file. 

Better yet, copy the code from the source file on this book's companion 
Web site. 



Creating the String Array Class 



Listing 34-1: Creating Your Own String Array Class 

#include <stdio.h> 



l_ ^ #iij»J^de <striig> 
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class MyStri ngArray 

{ 

string *_strings; 
int _numstrings; 
int _chunksize; 
int _numused; 
void expandt) 
{ 

// Allocate a new block 
string *newBlock = new string[ _num- 
strings + _chunksize ]; 

_numstri ngs += _chunksize; 

for ( int i=0; i<_numused; ++i ) 

newBlock[i] = _strings[i]; 
// Delete the old array 
delete [] _strings; 
// Re-assign the pointer 
_strings = newBlock; 

} 

public: 

MyStri ngArray ( voi d ) 

( 

_chunksize = 10; 

_strings = new string[ _chunksize ]; 
for ( int i=0; i <_chunks i ze ; ++i ) 

_strings[i] = ""; 
_numstrings = _chunksize; 
_numused = 0; 

} 

MyStri ngArray ( int nSize ) 

{ 

_chunksize = 10; 

if ( nSize <= _chunksize ) 



]; 



.strings = new string[ _chunksize 
_numstrings = _chunksize; 



el se 



.strings = new string[ nSize ]; 
_numst rings = nSize; 



_numused = 0; 

} 

virtual ~MyStri ngArray ( voi d ) 
{ 

delete [] _strings; 

} 

// Insert at start 

void i nsert_stri ng ( const string& s ) 
( 

// See if it will fit. 
if ( _numused == _numstrings ) 
expand ( ) ; 

// It will now fit, move everything up 
for ( int i=_numused; i>=0; --i ) 

_strings[i] = _strings[i -1] ; 
// Put in the new one 
_strings[0] = s; 
_numused ++; 

) 

void append_stri ng ( const string& s ) 
{ 

// See if it will fit. 

if ( _numused == _numstrings ) 

expand ( ) ; 
// Put in the new one 
_strings[_numused] = s; 
_numused ++; 

} 

string remove_at( int idx ) 
( 

i f ( i dx < 0 | | i dx >= _numused ) 

return stri ng ( " " ) ; 
// Save this one 

string ret_string = _strings[idx] ; 
// And copy all the others after it 
back 

for ( int i=idx; i<_numused; ++i ) 

_strings[i] = _strings[i+l] ; 
_numused- - ; 
return ret_string; 

1 

string get_at(int idx) 
{ 

i f ( i dx < 0 | | i dx >= _numused ) 

return stri ng ( " " ) ; 
return _strings[idx] ; 



int sizeO 



(continued) 
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Listing 34-1 (continued) 




int maintint argc, char **argv) 

{ 

MyStri ngArray s ( 5 ) ; 

for ( int i=0; Kargc; ++i ) 

{ 

pri ntf ( " Appendi ng %s\n", argv[i] ): 
s . append_stri ng( argv[i] ); 

} 

printfC "Initial String Array:\n"); 
for ( int j=0; j<s.size(); ++j ) 

pri ntf ( "Stri ng %d = [%s]\n", j, 
s . get_at ( j ) . c_str ( ) ) ; 
if ( s.sizeO > 5 ) 
{ 

string str = s . remove_at ( 5 ) ; 
pri ntf (" Removed string %s\n", 
str . c_str( ) ) ; 

) 

pri ntf ( " Fi nal String Array:\n"); 
for ( int i=0; i<s.size(); ++i ) 

pri ntf ( "Stri ng M = [%s]\n", i, 
s . get_at ( i ) . c_str ( ) ) ; 



When the program is run, if you have done every- 
thing properly, you should see the following output 
in the shell window: 



$ ./a. 

Append 
Appe 
Appe 
Appe 
Appe 
Appe 
Appe 
Appe 
Init 
Stri 
Stri 
Stri 
Stri 
Stri 
Stri 
Stri 
Stri 
Remo 
Fi na 
Stri 
Stri 
Stri 
Stri 
Stri 
Stri 
Stri 



exe 1 2 3 4 5 6 7 

i ng . / a 

nding 1 

nding 2 

nding 3 

nding 4 

nding 5 

nding 6 

nding 7 

ial String Array: 



ng 0 
ng 1 
ng 2 



[./a] 
[1] 
[2] 
[3] 
[4] 
[5] 
[6] 
[7] 

ved string 5 
1 String Array: 



ng 7 



ng 0 
ng 1 



ng 4 



[./a] 

[1] 

[2] 

[3] 

[4] 

[6] 

[7] 



This source code utilizes our simple array func- 
tionality to add, remove, and iterate over strings 
in an open-ended array structure. 

Now, our code is not quite as polished as the STL 
vector class, but it should work just as well. More 
importantly, when the code is compiled on my 
system, it produces an executable of less than 
100 KB (rather than the 400KB executable of our 
previous example), the majority of which is the 
STL string class. 

3. Save the source file in your code editor and 
close the code editor. 

4. Compile the source code with the compiler of 
your choice on the operating system of your 
choice. 



The output from this program is as expected: We 
append each of the input arguments to our array, 
watching it grow as we do so. This is illustrated begin- 
ning at the lines marked -* 1 in the code and -* 2 in 
the output. Next, we print out the array, expecting to 
see all of the values displayed (see -» 3 in the out- 
put). As expected, we see all eight data values. Next, 
the code removes the fifth data element, as shown at 
-> 4 in the code listing. We then print out the array 
once more, to show that the value was removed and 
the other data values remain. 
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Implementing your own array class can save you 
considerable time in trying to reduce code size, and 
allowsjfmi to use your code in places where it might 
ttl«j^i?{kO(n|jQ^[(Chemory constraints. 

AJ you can see from this output, we can create our 
own array class that implements the majority of the 
functionality of the STL vector class at a fraction of 
the memory and speed needed. 



7 



If memory or speed is an issue, stay away 
from the Standard Template Library and its 
array classes; roll your own. You will see 
marked speed increases, vastly less memory 
consumption, and greater ease of debugging. 
If you are not as concerned about memory 
usage, use the STL: It is already debugged and 
(no offense) probably better documented than 
your own classes. In addition, STL code is ver- 
satile: Versions of the STL have been ported to 
nearly all compilers and operating systems. 
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The real power of the Standard Template Library lies not in its abil- 
ity to simply store and retrieve data in templated form. Rather, it 
lies in the built-in algorithms you can use on the various storage 
facilities in the STL. Although the container classes do an excellent job of 
holding onto the data you put into them, the templated algorithms allow 
you to work with that data, sorting it, searching it, and converting it into 
other forms. 



I 

AN 



When you need to search, process, or remove specific items from a 
-a) group, strongly consider the STL storage classes rather than creating 
your own classes to do the same work. You can manipulate any of 
them with well-proven and debugged algorithms. 



The STL includes algorithm functions for iterating over collections, find- 
ing specific entries, removing specific entries, and sorting the entries in 
collections — to name but a few. In this technique, we look at the ways to 
manipulate data efficiently in a collection, using the algorithms available 
for vectors. In this technique, we will examine ways in which to sort, 
search and remove items in an STL container. These algorithms are avail- 
able for any of the STL container classes, using the same names in each 
case. Although we will focus on the vector class in this technique, the 
same algorithms will work with stacks, maps, queues, and all of the rest 
of the STL containers. Using these algorithms will save you time in doing 
the most likely tasks required of applications today. 



Working With Vector Algorithms 

If you are presented with an array, or vector, of data, certain functions 
are almost always going to be requested by the user. The ability to sort 
the data according to its value is one of them. Another requirement is 
almost certainly going to be the ability to find a given data value in the 
vector. Finally, inserting and removing data are essential for any array. 
Let's take a look at techniques for doing all of these tasks, using the STL 
vector class and the STL algorithms. Here's how: 
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f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
^source filg 

ile is named ch35 . cpp, 
although you can use whatever you choose. 




2. Type the code from Listing 35-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 35-1: Using the STL Algorithms with the vector Class 

//include <stdio.h> 
//include <string> 
//include <vector> 
//include <algorithm> 

bool contains_c( const std::string& s ) 

{ 

for ( int i=0; i <s . 1 ength ( ) ; ++i ) 
if ( s[i] == 'C ) 
return true; 
return false; 

} 

int maind'nt argc, char **argv) 

{ 

// First, create a vector out of all 
// of the input strings 

std::vector< std::string > elements; 

for ( int i=0; Kargc; ++i ) -* 1 

el ements . i nsert ( el ements . end ( ) , argv[i] ); 

// Print out the elements. 

pri ntf ( "Ori gi nal 1 i st : \n" ) ; 

std::vector< std::string >::iterator iter; 

for ( iter = el ements . begi n () ; iter != el ements . end () ; ++iter ) 
pri ntf ( " El ement %s\n", (*iter) .c_str( ) ); 

// Now, sort the elements. 

std::sort( el ements . begi n () , el ements . end ( ) ); -> 2 

// Print them out again, 
pri ntf ( "Sorted list:\n"); 

for ( iter = el ements . begi n () ; iter != el ements . end () ; ++iter ) 
pri ntf (" El ement %s\n", (*iter) .c_str( ) ); 



(continued) 
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Listing 35-1 (continued) 



II Find a specific element, if it exists. 

std::string >::iterator ptr_iter; 



|— ^ : vector^ std : : : 
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lnd( el ements . begi n () , el ements .end( ) , "Hello"); 
if ( ptr_iter != el ements .end( ) ) 

pri ntf( " Found the element %s\n", (*ptr_iter) .c_str( ) ); 
else 

pri ntf ( "Di dn ' t find the requested element\n"); 



// If we found it, remove it from the list, 
if ( ptr_iter != el ements . end( ) ) 
el ements . erase( ptr_iter ); 



// And relist them. 

pri ntf ( "Al tered list:\n"); 

for ( iter = el ements . begi n () ; iter != el ements . end( ) ; ++iter ) 
printft "Element %s\n", (*iter) .c_str( ) ); 

// See how many times "Why" is in the list. 

int cnt = std::count( el ements . begi n () , el ements .end( ) , "Why" ); 
pri ntf (" Found %d entries with the name \'Why\'\n", cnt ); 

// Remove entries only if they contain the letter 'c' 

std : : remove_i f ( el ements . begi n () , el ements . end( ) , contains_c ); 

p r i n t f ( " F i n a 1 1 i s t : \ n " ) ; 

for ( iter = el ements . begi n () ; iter != el ements .end( ) ; ++iter ) 
printft "Element %s\n", (*iter) .c_str( ) ); 

return 0; 



3. Save the source file in your code editor and 
close the code editor. 

This source code utilizes the power and function- 
ality of the Standard Template Library to do sim- 
ple array manipulations. Adding items, removing 
them, counting the number that match a given 
string, searching, and sorting the array are all 
illustrated. 



4. Compile the source code with the compiler of 
your choice on the operating system of your 
choice. 

When the program is run, if you have done every- 
thing properly, you should see the output shown in 
Listing 35-2 in the shell window. 
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Listing 35-2: Output from the Vector Algorithm Program 

$ ./a.exe Hello Goodbye Why What Iditarod 
ha Why Me Accord 



l^toha Why Me Acco 
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El 
El 
El 
El 
El 
El 
El 
El 
So 
El 
El 
El 
El 
El 
El 
El 
El 
El 
El 
Fo 
Al 
El 
El 
El 
El 
El 
El 
El 
El 
El 
Fo 
Fi 
El 
El 
El 
El 
El 
El 
El 
El 
El 



ement 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
rted 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
und t 
tered 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
und 2 
nal 1 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
ement 
ement 



o 
bye 



;arod 
ia 



3rd 



3rd 
ia 

ibye 
lo 

:arod 



Hel 
Goodt 
Why 
What 
Iditc 
Al phe 
Why 
Me 

Accor 
list: 
./a 
Accor 
Al phe 
Goodt 
Hel 
Iditc 
Me 

What 
Why 
Why 

he element Hello 
list: 
./a 
Accor 
Al phc 
Goodt 
Iditc 
Me 

What 

Why 

Why 

entries with the name 'Why' 
i st : 
./a 
Al ph6 
Goodt 
Iditc 
Me 

What 
Why 
Why 
Why 



3rd 
ia 

ibye 
:arod 



ia 

ibye 
:arod 



The output breaks down into several steps, matching 
the program steps. First, we input the data from the 
command line and store it into the original list, as it is 
marked in the output. This occurs at the line -> 1 in 
the code listing. Next, we sort the list, using the STL 
sort algorithm (shown at -> 2 in the code listing). 
This single line of code sorts the entire array, com- 
paring each element to the next and swapping them 
into place. The data is then output with the header 
sorted list. Our next task is to locate a specific string, 
in this case "Hello", within the array (see -> 3). If it 
is found, that element is removed and the array is 
printed out once more, using the title altered list. Our 
next task is to count the number of times a given 
string ("Why") appears in the list and print out that 
value. Finally, we remove all the items beginning 
with the letter c and print the list. All of this takes 
place in but a handful of lines of code, illustrating 
just how powerful and time saving the STL algo- 
rithms can be. 

As you can see, with a minimum of code, we accom- 
plished a rather large amount of functionality. For 
this reason alone, you should strongly consider 
using the STL vector class in your own code. 




The vector class implements numerous algo- 
rithms for sorting, searching, and manipulation. 
You can write a single function with multiple 
algorithms to process large amounts of data — 
or even selected portions of data — simply by 
using iterators and the algorithm functions. 
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Using the delete function with arrays can be one of the most confus- 
ing constructs in C++. When do you need to delete a single ele- 
ment, as opposed to an entire array of elements? What happens if 
you don't use the proper deletion method with the proper allocation 
method? Deleting a single element, when you allocate an array of ele- 
ments, results in the failure of destructors to be called. Not deleting an 
element you allocate results in memory leaks and potential system 
crashes. In general, the correct deletion method must be matched with 
the proper invocation of the new method. Failure to do this matchup will 
result in memory leaks that are very hard to trace — which will eventu- 
ally crash your application with enough use. If you do the work up front 
of matching correct allocations and de-allocations, you will save a lot of 
time during the debugging and maintenance process. 



Always match up the allocation with the deletion of elements in your 
application. When in doubt, use the delete array operations (delete 
[ ] array) rather than the "normal" deletion operation (delete 
array) to make sure your arrays are properly deleted. Even for non- 
class elements, failure to delete arrays properly can cause memory 
leaks. Note, however, that calling del ete [ ] when you have allo- 
cated a pointer with new <Type> will cause a crash. 




Examining Allocations 
of Arrays ana* Pointers 

The only real way to understand exactly how allocations and de- 
allocations work is to look at an example of working with allocating 
single objects, with and without pointers, in either single objects or 
arrays of objects. Let's do that right now, with a short example program. 

f m In the code editor of your choice, create a new file to hold the code 
for the implementation of the source file. 



In this example, the file is named ch36 . cpp, although you can use 
whatever you choose. 
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2. Type the code from Listing 36-1 into your file. 



return x; 



Better yet, copy the code from the source file on 
skicctruaajaipn Web site. 




Lifting 36-1: Allocating Objects with and 
without Pointers 

^include <stdio.h> 
^include <vector> 

class NoPointer 

{ 

i n t x ; 
public: 

NoPoi nter ( ) 

{ 

pri ntf ( "NoPoi nter : Void Constructor 
cal 1 ed\n " ) ; 
x = 0; 

} 

NoPointert int num ) 

{ 

pri ntf ( "NoPoi nter : Full constructor 
cal 1 ed\n " ) ; 
x = num; 

} 

NoPointert const NoPointer& aCopy ) 

{ 

pri ntf ( "NoPoi nter : Copy constructor 
cal 1 ed\n " ) ; 
x = aCopy.x; 

} 

virtual ~NoPointer() 

{ 

pri ntf ( "NoPoi nter : Destructor 
cal 1 ed\n" ) ; 



class PointerClass 
{ 

char *ptr; 
publ i c : 

Poi nterCl ass ( ) 
( 

pri ntf ( " Poi nterCl ass : Void Constructor 
cal 1 ed\n " ) ; 
ptr = NULL; 

1 

Poi nterCl ass ( const char *str ) 
{ 

pri ntf (" Poi nterCl ass : Full constructor 
cal 1 ed\n " ) ; 

ptr = new char[ strl en ( str )+l ]; -* 1 

strcpy ( ptr , str ) ; 

I 

Poi nterCl ass ( const Poi nterCl ass& aCopy ) 
{ 

pri ntf (" Poi nterCl ass : Copy constructor 

cal 1 ed\n " ) ; 

if ( aCopy.ptr ) 

{ 

ptr = new chart strl en ( aCopy . ptr )+l ]; 
strcpyt ptr, aCopy.ptr ); 

1 

el se 

ptr = NULL; 

1 

virtual ~Poi nterCl ass ( ) 
1 

pri ntf ("Poi nterCl ass: Destructor 
cal 1 ed\n " ) ; 

del ete [] ptr; -> 2 



NoPointer operator=( const NoPointerS 
aCopy ) 

{ 

pri ntf ( "NoPoi nter : operator- 
cal 1 ed\n " ) ; 
x = aCopy.x; 
return *this; 

I 

void setX( int num ) 



PointerClass operator=( const 

Poi nterCl ass& aCopy ) 

{ 

pri ntf ("Poi nterCl ass: operator- 

cal 1 ed\n " ) ; 

if ( aCopy.ptr ) 

{ 

ptr = new char[ strl en ( aCopy . ptr )+l ]; 
strcpyt ptr, aCopy.ptr ); 



int getX (void) 



else 

ptr = NULL; 



(continued) 
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Listing 36-1 (continued) 



return *this; 



Drop Books 

if ( str ) 



char *str ) 



str = new char[ strl en( str )+l ]; 
strcpy ( ptr , str ) ; 

} 

else 

ptr = NULL; 

} 

const char *getPtr (void) 



return ptr; 



}; 



int main( ) 

{ 

// Just create one of each to see what 

happens . 
pri ntf ( "Creati ng np\n"); 
NoPointer *np = new NoPoi nter( 5 ) ; 
pri ntf ( "Creati ng pc\n"); 
PointerClass *pc = new 
PointerClass(" Hello"); 
pri ntf ( " Del eti ng np\n"); 
delete np; 

pri ntf (" Del eti ng pc\n"); 
delete pc; 

// Now, create an array of them, 
pri ntf ( "Creati ng npa\n"); 
NoPointer *npa = new NoPoi nter[5] ; 
pri ntf ( "Creati ng pca\n"); 
PointerClass *pca = 

new PointerCl ass[5] ; -* ' 

II Delete them. 

pri ntf (" Del eti ng npa\n"); 

delete npa; 

pri ntf (" Del eti ng pca\n"); 
delete pea; 

// Now, do it the right way. 

pri ntf ( "Creati ng npa2\n"); 

NoPointer *npa2 = new NoPoi nter[5] ; 

pri ntf ( "Creati ng pca2\n"); 

PointerClass *pca2 = new Poi nterCl ass[5] ; 



// Delete them. 

pri ntf (" Del eti ng npa2\n"); 

delete [] npa2; 

pri ntf (" Del eti ng pca2\n"); 

delete [] pca2; 

// See what happens with a vector, 
pri ntf ( "Creati ng vector of 
Poi nterCl ass\n" ) ; 

std::vector< PointerClass > *pcv = new 
std: :vector<Poi nterCl ass>; 

for ( int i=0; i<5; ++i ) 
I 

PointerClass pc; 
pcv->insert(pcv->end( ) , pc ); 

I 

pri ntf (" Del eti ng vector of 
Poi nterCl ass\n" ) ; 
delete pev; 



As you can see from the above code listing, we 
have created two different sorts of classes. The 
first class, NoPoi nter, is a simple class that con- 
tains only basic member variables, with no point- 
ers stored in the member data of the class. The 
second class, Poi nterCl ass, contains pointer 
data that is allocated when an instance of the 
class is constructed and de-allocated when the 
instance is freed. If you look at line -* 1 , you will 
see how the ptr member variable is allocated in 
the constructor for the Poi nterCl ass. That ptr 
member variable should be de-allocated at line 
-> 2 if all goes well in the class. 

3, Save the source file in your code editor and 
close the code editor. 

4. Compile the source code with the compiler of 
your choice on the operating system of your 
choice. 
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When the program is run, if you have done every- 
thing properly, you should see the output shown in 
Listin^fi-2 in the shell window. 

DropBooks 

LiIting 36-2: The Output from the Allocation Example 

$ ./a.exe 

Creating np 

NoPointer: Full constructor called 
Creating pc 

Poi nterCl ass : Full constructor called 
Deleting np 

NoPointer: Destructor called 
Deleting pc 

Poi nterCl ass : Destructor called 



Creating npa 
NoPoi nter 
NoPoi nter 
NoPoi nter 
NoPoi nter 
NoPoi nter 
Creati ng 
Poi nterCl 
Poi nterCl 
Poi nterCl 
Poi nterCl 
Poi nterCl 
Del eti ng 
NoPoi nter 
Deleting pea 
Poi nterCl ass : 
Creating npa2 



Void Constructor called 

Void Constructor called 

Void Constructor called 

Void Constructor called 

Void Constructor called 



pea 
lass: 
lass: 
lass: 
lass: 
lass: 



Void Constructor called 

Void Constructor called 

Void Constructor called 

Void Constructor called 

Void Constructor called 



npa 

: Destructor called 



Destructor called 



NoPoi 


nter : 


Void 


Constructor 


ca 


led 


NoPoi 


nter : 


Void 


Constructor 


ca 


led 


NoPoi 


nter : 


Void 


Constructor 


ca 


led 


NoPoi 


nter : 


Void 


Constructor 


ca 


led 


NoPoi 


nter : 


Void 


Constructor 


ca 


led 



Void Constructor called 

Void Constructor called 

Void Constructor called 

Void Constructor called 

Void Constructor called 



Creating pca2 
Poi nterCl ass : 
Poi nterCl ass : 
Poi nterCl ass : 
Poi nterCl ass : 
Poi nterCl ass : 
Deleting npa2 

NoPointer: Destructor called 
NoPointer: Destructor called 
NoPointer: Destructor called 
NoPointer: Destructor called 
NoPointer: Destructor called 



Del eti ng 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Creati ng 
Poi nterC 
Poi nterC 
P o i n t e r C 
Poi nterC 
Poi nterC 
Poi nterC 
P o i n t e r C 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Del eti ng 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 
Poi nterC 



pca2 
ass : 
ass : 
ass : 
ass : 
ass : 



Destructor ca" 
Destructor ca" 
Destructor ca" 
Destructor ca" 
Destructor ca" 



led 
led 
led 
led 
led 



vector of PointerClass 

ass: Void Constructor called 

ass: Copy constructor called 

ass: Destructor called 

ass: Void Constructor called 

ass: Copy constructor called 

ass: Copy constructor called 

ass: Destructor called 

ass: Destructor called 

ass: Void Constructor called 

ass: Copy constructor called 

ass: Copy constructor called 

ass: Copy constructor called 

ass: Destructor called 

ass: Destructor called 

ass: Destructor called 

ass: Void Constructor called 

ass: Copy constructor called 

ass: Destructor called 

ass: Void Constructor called 

ass: Copy constructor called 

ass: Copy constructor called 

ass: Copy constructor called 

ass: Copy constructor called 

ass: Copy constructor called 

ass: Destructor called 

ass: Destructor called 

ass: Destructor called 

ass: Destructor called 

ass: Destructor called 
vector of PointerClass 

ass: Destructor called 

ass: Destructor called 

ass: Destructor called 

ass: Destructor called 

ass: Destructor called 



The important part of this output is shown in the 
lines marked with -> 5 and -* 6 As you can see, we 
are de-allocating the pointers that we allocated in 
the code at lines marked -+ 3 and 4. In both cases, 
we have allocated an array of objects. If you look at 
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the output, you will see that the constructor for the Always place debugging print statements in 
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that the destructor is called only once. VjSj/ vou have called each the P ro P er number of 
-Sate memory leak in the times and in the proper manner. 



-> 7) bulihat the destructo 

DrciprBows 




DropBooks 

Techn' 



Creating Arrays 
of Objects 



Save Time By 




V Understanding th 


e vari- 


ouswaysto create arrays 


of objects 




Declaring arrays 


on the 


stack 




V Creating objects 


an the 


heap 




V Using STL contai 


ner 


classes to create 


arrays 


Interpreting your 


output 



c 



++ offers three different ways to create arrays of objects, using the 
language constructs and the Standard Template Library (STL): 



Declaring arrays on the stack: This method, using the [ ] construct, 
creates a static array that exists from the point at which it is allocated. 
You create a static array by writing 

object-type array[ num-el ements~\; 

where object-type is the class of the object you wish to create an 
array of, and the number of elements in the array is represented by the 
num-el ements parameter. The advantage to this approach is that the 
array size is known at compile time, and the program will be loaded 
with the proper amount of memory. The problem with this approach is 
that the array exists only as long as the array is in scope. When the 
array variable goes out of scope, the array is destroyed. 

i/ 0 Creating objects on the heap: This approach has the advantage 
of allowing you to control exactly when the array is created or 
destroyed — but a disadvantage is that it will not automatically 
"clean up" (de-allocate) after you. If you fail to de-allocate an array 
(or if you de-allocate it in the wrong way), you create a memory leak 
in your program. You create an object on the heap by writing 

object-type object; 

Using STL container classes to create arrays: (We could quibble over 
whether the various container classes in the STL constitute separate 
methods of creating arrays, but for the sake of this technique, we'll 
just consider the use of all of the various container classes as a single 
approach.) The advantage of this method is that it does not create the 
objects until they are actually inserted into the container class — and 
it automatically destroys those objects when the container class goes 
out of scope. Containers can be dynamically created on the stack so 
you can control the scope of objects in the container as well. Two dis- 
advantages to this method: The increase in overhead is significant, and 
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the container classes require you to implement a 
number of methods in your classes — such as 
constructors, assignment operators, and 
to avoid memory leaks, 
itainer class by writing: 

vector<object-type> array; 

This technique looks at the various advantages and 
disadvantages of creating objects in these three dif- 
ferent ways. By understanding how you can most 
easily create an array of objects in your code, you 
will save time when writing, debugging, and optimiz- 
ing your code. 

The following steps take you through all three 
techniques for object-array allocation in a single 
example: 

f. In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch37 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 37-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 37-1: Creating an Array of Objects 

#i include <stdio.h> 
#include <string> 
^include <vector> 

class Foo 
{ 

std : : stri ng _str ; 
publ i c : 

Foo(void) 
{ 

printf("Foo: Void constructor^ ") ; 
_str = " " ; 

) 

Foo ( const char *s ) 



printf("Foo: Full constructor 
[%s]\n", s); 
_str = s; 

Foo( const Foo& aCopy ) 

printf("Foo: Copy constructor^ " ) ; 
_str = aCopy._str; 

vi rtual ~Foo( ) 

printf("Foo: Destructor\n " ) ; 

Foo operator=( const Foo& aCopy) 

_str = aCopy._str; 
return *this; 

std : : stri ng Stri ng( ) 

return _str; 

void setString( const char *str ) 

_str = str; 



i nt mai n ( ) 

{ 

pri ntf ( "Creati ng array via new\n"); 
Foo *f = new Foo[2] ( "Hel 1 o" ) ; -9 
pri ntf ( "Creati ng array on heap\n"); 
Foo fl[3] ; -s 

// Create a vector 

pri ntf ( "Creati ng vector of foo\n"); 

std : : vector<Foo> fooVector; 

pri ntf ( " Addi ng objects to vector\n"); 
Foo fZ; 
Foo f3; 
Foo f4; 

fooVector . i nsert( fooVector . end( ) , fZ ) 
fooVector . i nsert( fooVector . end( ) , f3 ) 
fooVector . i nsert( fooVector . end( ) , f4 ) 

pri ntf ( "Del eti ng array on heap\n"); 
delete [] f; 
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Looking at the above code listing, you can see 
that there are three different arrays defined in 
we allocate an array from 
new operator. At -* 2, we 
the heap, using the standard 
array syntax of C++. Finally, at -> 3, we see how 
the Standard Template Library vector class is 
used to define an array of objects. 

3. Save the source file in your code editor and 
close the code editor. 

4. Compile the source code with the compiler of 
your choice on the operating system of your 
choice. 

When the program is run, if you have done 
everything properly, you should see the output 
shown in Listing 37-2 in the shell window. 

Listing 37-2: Output from the Array-Allocation Program 



Foo: Destructor 

Foo: Destructor 

Foo: Destructor 

Foo: Destructor 



$ ./a 

Creat 
Foo : 
Foo : 
Creat 
Foo : 
Foo : 
Foo : 
Creat 
Addi n 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 
Del et 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 
Foo : 



. exe 

i ng a 

Ful 1 

Ful 1 

i ng a 

Void 

Void 

Void 

i ng v 

g obj 

Void 

Void 

Void 

Copy 

Copy 

Copy 

Destr 

Copy 

Copy 

Copy 

Destr 

Destr 

i ng a 

Destr 

Destr 

Destr 

Destr 

Destr 

Destr 

Destr 



rray 

const 

const 

rray 

const 

const 

const 

ector 

ects 

const 

const 

const 

const 

const 

const 

uctor 

const 

const 

const 

uctor 

uctor 

rray 

uctor 

uctor 

uctor 

uctor 

uctor 

uctor 

uctor 



via new 
ructor [Hel 
ructor [Hel 
on heap 
ructor 
ructor 
ructor 

of foo 
to vector 
ructor 
ructor 
ructor 
ructor 
ructor 
ructor 

ructor 
ructor 
ructor 



on heap 



o] 
o] 



As you can see, the static array is created at the 
point at which the compiler finds the code for it. The 
dynamic array is created at the point at which the 
new operator is used to allocate it, and the vector 
array does not begin to allocate space for the 
objects until they are inserted into the vector. 
Take a look at a breakdown of the lines shown in 
Listing 37-2: 

-» 4 This line shows the point at which the array 
is allocated with new. As you can see, two con- 
structor calls are made, indicating that two 
objects were created and put into the array. Note 
that because we gave the new operator a con- 
structor argument, it calls the full constructor for 
the class. 

-* 5 This line shows where we allocated a block 
of objects on the heap, using standard C++ array 
syntax. Note that the void constructor is used 
for these objects, initializing all three of them 
(one for each array element). 

-> 6 This line shows where we used the Standard 
Template Library vector class to store objects. 
No objects were created in this call. We then allo- 
cate several objects on the heap and add them to 
the vector. Notice that the objects are copied 
into the vector using the copy constructor to 
create new instances of the class. 

-» 7 Here we delete the array that we allocated 
with the new call. There should be two objects 
deleted in this process and the output shows 
that there are, in fact, two objects destroyed. 

i>* -* 8 This line shows the final destruction of the 
objects that were allocated in the array on the 
heap. 

If you count the total number of destructor calls at 
the end of the output listing, you will see that there 
are 1 1 of them. This might not seem obvious from 
the fact that we allocated only eight objects in the 
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main program (two in the new array, three in the heap 
array, and three in the vector). However, because 
the coqx^nstructor was invoked three times, three 
tofJ^rfsVitfeQeated, making a total of 1 1. 




If you take a look at the output from the pro- 
-a) gram (in Listing 37-2), you see that the vec 
tor class does significant manipulation of the 
data in the vector — that's to store it efficiently 
and make room for new objects. Therefore, if 
your objects require a lot of overhead for their 
creation and destruction, the vector class is 
not a good choice for a container. You would 
be better off pre-allocating a large number of 
the objects — and using that array, whether 
static or dynamic, to store your information. 



One important thing to notice in the code is that we 
always use the delete [ ] method for de-allocating 
arrays of objects. If you replace the del ete [ ] 
method with a simple del ete call, you will find that 
the code does not call the destructor for each mem- 
ber of the array, and that memory leaks can easily 
occur. This risk of memory leakage is particularly 
important if you store pointers to objects in your 
array, and access them through any sort of base 
class. 
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Although simple arrays of objects are easy to work with, arrays of 
pointers that indicate objects are slightly more complicated to 
handle. The syntax for creating and deleting these arrays is a little 
more difficult; heterogeneous arrays of pointers that point to a common 
base object require a bit more work — and this technique guides you 
through what must be done. C++ allows you to store pointers to all 
related classes — that is, those derived from a common base — in a sin- 
gle array, while keeping track of their types and sizes. This can save you 
a lot of time, by allowing you to place all of the related objects in a single 
array while processing them differently using their derived types. 



You can save a lot of time by storing all objects that derive from a 
common base in a single array for access — as long as you have a 
way to access the objects consistently. If you do so, you must use a 
virtual destructor in the base class to insure that all de-allocations are 
done properly. If you do not do this, the destructors for the derived 
classes will not be called, and potential memory leaks can occur. 




Creating an Array of Heterogeneous Objects 

If you are working with a batch of different classes, all derived from a sin- 
gle base class, it can be advantageous to store them all in one place. For 
one thing, you only have one array to work with. For another, because 
the objects are all related, it is likely that you will be doing the same pro- 
cessing on them all at the same time. Let's look at an example of creating 
a heterogeneous array that stores multiple classes of objects. 

f. In the code editor of your choice, create a new file to hold the code 
for the implementation of the source file. 

In this example, the file is named ch38 . cpp, although you can use 
whatever you choose. 

2. Type the code from Listing 38-1 into your file. 



Better yet, copy the code from the source file on this book's compan- 
ion Web site. 
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Listing 38-1: Creating an Array of Object Pointers 

^include <stdio.h> 
#in#i*de <strir|g.h> 




class Base 



pub 



char *ptr; 

i c : 
Base(void) 



ptr = NULL; 

Base( const char *str ) 

setStri ng( str ) ; 

vi rtual ~Base( ) 

pri ntf ( " Base:: -Base cal 1 ed\n " ) ; 
delete ptr; 

void setString( const char *str ) 

ptr = new char [strl en ( str )+l] ; 
strcpy ( ptr , str ) ; 

const char *getString() 

return ptr; 



voi d setVal ( i nt nVal ) 
1 

_num = nVal ; 

} 

int getVal ( void ) 
1 

return _num; 



const int NumElements = 3; 

int main(void) 
{ 

Base **bArray = new Base*[10]; -> 1 

for ( int i=0; i <NumEl ements ; ++i ) 

bArray[i] = new Derived(i); -* 2 

II Print them out 

for ( int j=0; j <NumEl ements ; ++j ) 

pri ntf ( "Object %s - %d\n", bArray[j]- 
>getStri ng( ) , ((Derived *)bArray[j] )- 
>getVal ( ) ) ; 

// Delete them 

for ( int i=0; i <NumEl ements ; ++i ) 
del ete bArray [i ] ; 

delete [] bArray; 
return 0; 



class Derived : public Base 
{ 

pri vate : 

int _num; 
publ i c : 

Deri ved( void) 

: Base( "Deri vedVoi d" ) 

{ 

_num = 0; 

} 

Derived( int nVal ) 

: Base( "Deri vedFul 1 " ) 

{ 

_num = nVal ; 

) 

vi rtual -Deri ved( ) 
{ 

printf("De rived: :~Deri ved cal 1 ed\n " ) ; 

) 



The above code listing illustrates how we create 
an array of pointers and store data in that array. 
As you can see at -> 1 , allocating an array of 
pointers is no different than allocating any other 
sort of array in C++. The difference here is that 
while the array space is allocated, no actual 
objects are created. This is because we are allo- 
cating space for pointers to the objects, not 
objects themselves. The actual allocation of 
objects and the space they consume is illus- 
trated at the line marked -> 2. Note that even 
though we have an array of Base pointers, we 
can create and store Deri ved pointers in the 
array, since they are a derived form of Base . 
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3. Save the source file in your code editor and 
close the code editor. 
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When the program is run, if you have done every- 
thing properly, you should see the following output 
in the shell window: 

$ . /a . exe 

Object DerivedFull - 0 
Object DerivedFull - 1 
Object DerivedFull - 2 
Deri ved : :~Deri ved called 
Base : :~Base cal 1 ed 
Deri ved : :~Deri ved called 
Base : :~Base cal 1 ed 
Deri ved : :~Deri ved called 
Base : :~Base cal 1 ed 



The output here illustrates that the array of pointers 
is created as we expected. The string stored in the 
Base class was created from the Deri ved constructor, 
which is what we anticipated. The destruction of the 
objects does chain upward to call both the Base 
class and Deri ved class destructors. In short, this 
code works exactly as advertised. 

The ability to work with an array of heterogeneous 
pointers is quite powerful in C++, because it means 
that you need not know what sort of object you are 
working with. Had we created virtual methods for 
getting and setting the values in the Base class, we 
would not even have to cast the object in the pri ntf 
in the main function. 
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One of the most famous (or perhaps infamous) applications to help 
make the personal computer popular was the spreadsheet — 
nothing more than a grid of cells arranged in rows and columns — 
in other words, a two-dimensional array. Spreadsheets have more func- 
tionality than simple arrays (for example, you can build in formulae), but 
at its heart, a spreadsheet is an array of rows and columns. This tech- 
nique uses the Standard Template Library (STL) to set up and implement 
a spreadsheet shell. The result can easily be used to create a real spread- 
sheet implementation. Spreadsheets are common elements of applica- 
tions these days, from doing presentations of data to what-if analysis. By 
having a generic spreadsheet class that you can drop into your next proj- 
ect, you will find that you save a lot of time in both the design and imple- 
mentation phase of the project. 



/^~^\ The implementation shown here isn't designed to work with or inter- 
( ifO ) P ret f° rmL| l ae ' DUt it w iH do everything else. If you want a complete 
VJJ/ spreadsheet that can handle formulae, all you need to do is incorpo- 
rate a simple expression parser. 



The basics of the spreadsheet are three elements: the column (or cell), the 
row, and the sheet itself. Each column contains a piece of data and the 
information for formatting that piece of data for display. The column con- 
tains methods to copy itself, clear itself out, and modify the data or for- 
matting information in itself. The row is simply an array of columns that 
makes up a single row of the spreadsheet. The Row class needs to be able 
to modify any existing column in the row, as well as add new columns 
and remove columns. A row should be able to return the contents of any 
given column within that row so that the end user can modify the con- 
tents directly. 

Finally, the Spreadsheet class will contain an array of rows. This array 
knows nothing about the individual columns in the sheet, nor does it 
know anything about formatting or data. This data encapsulation is con- 
sistent with the object-oriented paradigm, certainly, but is also important 
in terms of being able to easily modify the basic layers of the system with 
minimal change to the upper layers. 
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When you're implementing a complex system, 
-a) you can save immense time by breaking it 
do wn into the most discrete simple compo- 
I A r^nt^QH^Jru^ru^e. This way, when change is 

I J I 11 II ^^tdACay|^i J^e amount of required effort 
1^ is smaller and the ripple effect throughout the 
system is minimal. 



Creating the Column Class 

The first element of the spreadsheet is the column. 
Let's build a simple class that maintains information 
about the column, and contains methods to work 
with that information. Here's how: 

/. In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch39 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 39-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 39-1: The Column Class 

#include <stdio.h> 
#i include <string> 
#include <vector> 

class Column 

{ 

std : : stri ng _f ormat ; 
std : : stri ng _val ue ; 
public: 

Co 1 umni void) 

{ 

_f ormat = "%s"; 
_v a 1 u e = " " ; 



Columni const Column^ aCopy ) 

_format = aCopy ._f ormat ; 
_value = aCopy ._val ue ; 

virtual ~Column() 



Column operator=( const Column^. aCopy ) 

_format = aCopy ._f ormat; 
_value = aCopy ._val ue ; 
return *this; 

Column operator=(const char *value) 

_value = value; 
return *this; 



void setValue( const char *value ) 

_value = value; 

std::string getValuet void ) 

return _value; 

void setFormatt const char *format ) 

_format = format; 

std::string getFormat( void ) 

return _format; 

virtual std::string getFormattedStri ng 
( void ) const -* 

char szBuffer[ 100 ]; 
sprintftszBuffer, _f ormat . c_str ( ) , 
_val ue . c_str( ) ) ; 
std::string sRet = szBuffer; 
return sRet; 



Columni const char *format, const char 
*value ) 



.format = format; 
.value = value; 
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This code implements the most basic element of 
the spreadsheet system, the column. As you can 
we implement a complete class by adding 
itructors, destructors, 
and accessor methods. 
It also implements a virtual method (shown at 
-* 1) for returning the contents of the column in 
a formatted manner. Doing so allows other col- 
umn types to be defined later on down the line, if 
you so desire. 

3. Save your file in your code editor. 

The next step is to implement the Row class that will 
hold an array of columns. 

Creating the Row) Class 

After we have created a Col umn class, the next thing to 
do is to create a Row class that contains the columns 
we wish to store in the spreadsheet. You can think of 
the Col umn class as the data for a single cell, and the 
Row class as a list of cells for a given row. 

f m Append the code from Listing 39-2 to the end of 
your file. 

Listing 39-2: The Row Class 

class Row 

{ 

std : : vector< Column > _columns; 

void Copy( const Row& aCopy ) 

{ 

std::vector< Column >::const_ 

iterator iter; 
for ( iter = aCopy ._col umns . begi n ( ) ; 

iter != aCopy ._col umns . end () ; 

++iter ) 

_col umns . i nsert ( _col umns . end ( ) , 
(*iter) ); 

} 

publ i c : 

Row{ voi d ) 



Row( unsigned int numColumns ) 
{ 

for ( int i=0; i <numCol umns ; ++i ) 



Column c; 

_col umns . i nsert ( _col umns . end( ) , 



c ); 



Row( const Rowlk aCopy ) 
( 

Copy ( aCopy ) ; 

} 

Row operator=( const Rowlk aCopy ) 
1 

Copy ( aCopy ) ; 

} 

Columns operator[]( int idx ) -* 
( 

if ( idx < 0 || idx > _columns. 
size()-l ) 

throw "Row: Index out 
of range"; -* 
return _columns[ idx ]; 

} 

int NumColumns( void ) 

( 

return _col umns . si ze( ) ; 

) 

void C 1 e a r ( ) 
1 

std::vector< Column >::iterator 
iter; 

for ( iter = _col umns . begi n () ; 
iter != _col umns . end () ; ++iter ) 
(*i ter ) . setVal ue( "" ); 

} 

voi d Pri nt( ) const 
( 

std::vector< Column >::const_ 

iterator iter; 
for ( iter = _col umns . begi n () ; 
iter != _col umns . end () ; ++iter ) 
pri ntf ( "%s " , 
(*iter) . get Forma ttedSt ring ( ) .c_str( ) ) ; 
pri ntf ( "\n " ) ; 
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Note that the Row class does not do anything 
with the columns, except to store them and give 
^ccess to the ones they want. Note 
option handling (shown at 
: exceptional cases of array 
indices out of bounds. There are no good defaults 
possible here, so we just assume that it is a fatal 
error to ask for an invalid column number. 
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One thing that could be changed here is that the 
Row class does not handle resizing. Instead, the 
Row class simply assumes that the array of 
columns is always being instantiated from 
scratch. To properly resize a row, you would 
need to create a new array of columns of the 
right size, and then copy the existing columns 
into that row. 

2. Save your file. 

The final step of the process of implementing the 
class is to put together the actual Spreadsheet class. 
The next section shows how. 



_rows . erase (_rows . begi n ( ) , 

_rows . end( ) ) ; 

// Now, add in the rows. 

for ( int i=0; KnRows; ++i ) 

{ 

Row row( nCol s ) ; 
_rows . i nsert ( _rows.end() : 
row ) ; 



void _Internal SetRows ( const unsigned 
int nRows ) 

I 

_BuildSheet( nRows, _cols ); 

) 

void _Internal SetCol s ( const unsigned 
int nCols ) 

{ 

// Save the number of rows, so we 

can rebuild it. 
int nRowCount = _rows . si ze( ) ; 
// Set the number of columns. 
_cols = nCols; 
// Now rebuild the rows. 
_BuildSheet( nRowCount, nCols ); 



Creating the Spreadsheet Class 

Finally, we come to the important part for the end- 
user: the Spreadsheet class itself. A spreadsheet, of 
course, is simply a list of the rows that make up the 
sheet, which in turn is a list of the columns that 
make up each row. Our spreadsheet will always be 
"square" — that is, it will contain an equal number of 
columns in each row. 

/. Append the code from Listing 39-3 to the end of 
your file. 

Listing 39-3: The Spreadsheet Class 

class Spreadsheet 

{ 

int _cols; 
std::vector< Row > _rows; 
std : : stri ng _name ; 

void _BuildSheet( int nRows, int nCols ) 

{ 

// If there is anything already 
here, remove it. 



void Copy( const Spreadsheets aCopy ) 
{ 

_Internal SetCol s ( aCopy. 
NumCol umns ( ) ) ; 

std::vector< Row > : : const_i terator 
iter; 

for ( iter = aCopy ._rows . begi n ( ) ; 
iter != aCopy ._rows . end( ) ; ++iter ) 
_rows . i nsert ( _rows.end(), 
(*iter) ); 

_name = aCopy._name; 

) 

publ i c : 

Spreadsheet ( voi d ) 



Spreadsheets const char *name ) 
{ 

_name = name; 

} 

Spreadsheets const char *name, unsigned 
int nRows, unsigned int nCols ) 

{ 

(continued) 



Technique 39: Implementing a Spreadsheet 



Listing 39-3 (continued) 



_name = name; 
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Internal SetCol s( nCols ); 

ows ( nRows ) ; 



Spreadsheets const Spreadsheets aCopy ) 

{ 

Copy ( aCopy ) ; 

} 

pread beet operator=( const 
Spreadsheets aCopy ) 

I 

Copy ( aCopy ) ; 
return *this; 

I 

Row& operator[]( int idx ) -> 4 

{ 

if ( idx < 0 || idx > _rows. 
size()-l ) 

throw "Spreadsheet: Index out of 
range" ; 
return _rows[idx] ; 

} 

Spreadsheet operator( ) ( i nt rl, int cl, 
int rZ, int c2) 

Spreadsheet ret; 

// Assign the pieces. 

ret . setNumCol umns ( c2-cl+l ); 

ret . setNumRows ( r2-rl+l ); 

// Now copy over the chunk they want, 
try 

{ 

for ( i nt r = rl ; r <= r2 ; ++r ) 
for ( int c = cl; c <= c2; 
++c ) 

ret [ r- rl ] [c-cl ] = 
(*this)[r][c] ; 



catch ( 



) 



throw "Spreadsheet : Index out of 
range" ; 

} 

return ret; 

) 

void setNumCol umns ( int nCols ) 

{ 

_Internal SetCol s( nCols ); 

} 

void setNumRows( int nRows ) 



_Internal SetRows ( nRows ); 

nt NumColumnsO const 

return _col s ; 
nt NumRows ( ) const 

return _rows . si ze( ) ; 
void setName( const char *name ) 

_name = name; 
std::string getName( void ) const 
return _name; 

voi d Pri nt( ) const 

std::vector< Row > : : const_i terator 
iter; 

pri ntf( " Sheet : %s\n", _name . c_str( ) 
) ; 

for ( iter = _rows . begi n ( ) ; iter ! = 
_rows.end(); ++iter ) 

( 

(*iter) . Printt ) ; 



void C 1 e a r ( ) 
( 

std::vector< Row >::iterator iter; 
for ( iter = _rows . begi n ( ) ; iter ! = 
_rows.end(); ++iter ) 
(*iter) .Clear( ) ; 



As I mentioned earlier in this technique, the 
spreadsheet is really just a holder of rows, which 
in turn are a holder of columns. The Col umn class 
is the only one that "understands" what the data 
being stored looks like, or how it is formatted, or 
how it will be displayed. The Spreadsheet class 
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provides access to the individual rows in the 
sheet, without any knowledge of how the 
lumns are siored in each row. 
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Testing \lour Spreadsheet 

To see that the code is really working, implement a 
test driver for the code. The following steps show 
you how: 

f m In the code editor of your choice, reopen the 
source file for the code that you just created. 

In this example, the file is named ch39 . cpp, 
although you can use whatever you choose. 

2. Append the code from Listing 39-4 to the end of 
your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 39-4: The Spreadsheet Test Driver 

int maind'nt argc, char **argv) 

{ 

Spreadsheet slC'Sheetl", 10, 10 ); 

// Initialize the spreadsheet, 
for ( int i=0; i <sl . NumRows ( ) ; ++i ) 
for ( int j=0; j <s 1 . NumCol umns ( ) ; 
++J ) 



sl[i][j] = "*"; 

si [i ] [ j ] . set Format ( "%6s " ) ; 



I 




// Set some values. 

sl[5][4] = "Hello"; 5 
sl[0][0] = "Begin"; 

// Display it so that the user can see 
it. 

si . Printt ) ; 

// Get a slice of the spreadsheet. 
Spreadsheet s2 = si ( 0 , 0 , 3 , 3 ) ; 
s2. setName( "Sheet 2" ) ; 
s2. Printt ) ; 

// Change a column, so we know that it 

works . 
s2[2][2] = "!"; 
s2. Print ( ) ; 

// Now, clear out the original sheet and 

display it. 
si . CI ear( ) ; 
si . Printt ) ; 



When the program is run, if you have done every- 
thing properly, you should see the output from 
Listing 39-5 in the shell window. 



Listing 39-5: The Output from the Spreadsheet Test Driver Application 

Sheet: Sheetl 

ggg-jp * * * * * * * * * 

********** 
********** 
********** 
********** 

* * * * Hello * * * * * 

********** 
********** 
********** 
********** 



(continued) 
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Sheet: Sheet 2 
Begin * 



Sheet: Sheetl 



The output shown indicates the state of the spread- 
sheet at the time it is displayed. An asterisk (*) is 
shown in any cell that contains no data, while cells 
that do contain data are shown with the data value. 
For example, you will see the string Hello in the cen- 
ter of Sheetl, which was placed there at -* 5 in the 
code listing for the main driver. Likewise, the top left 
corner of Sheetl contains the string Begi n, which 
was placed there at the following line in the driver 
program. 

We could easily use this spreadsheet class to store 
data, display it for the user, or manipulate data that 
is contained in a row/column definition. 

The asterisks are simply placeholders to show 
where the actual column data should be. As you can 




see, the data values that we set in our test driver 
show up where they're supposed to. 



You can't truly implement a two-dimensional 
array in C++, since there is no operator [][]. 
However, if you look at the code, you can see 
a way to implement an operator that returns 
another class that implements the same opera- 
tor. The spreadsheet class implements an 
operator [] (shown by the -* 4 in Listing 39-3) 
which returns the row requested by the index. 
The row class then implements the opera 
tor[] (shown by the -» 3 line in Listing 39-2) 
to return the column requested by the index. 
That's why [row] [col ] = value works. 
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Using the Standard 
Streams to Format 
Data 



If you've been programming in C++ for a long time, you're probably 
used to outputting data with the pri ntf , f pri ntf , and spri ntf func- 
tions that date back to the C programming days. It is now time to take 
the plunge into using the stream components of the standard C++ library, 
because these components will save you lots of time and heartache. The 
stream components support input, output, and formatting for data in C++ 
applications. Like the pri ntf, f pri ntf, and spri ntf functions, streams 
exist to write to the console, to files, and to format data into strings. 
Unlike the aforementioned functions, streams are type-safe and extensi- 
ble, which saves you time by reducing the amount of code you need to 
write and the amount of debugging you need to do to find problems in 
output. 

The stream components save time by being type-safe, well written, 
and comprehensive. If you use streams instead of more specific out- 
put functions, you will find that your code is smaller, easier to under- 
stand, and more portable. 

Although most programmers are aware that you can input and output 
data through the stream classes, most are unaware that the stream 
classes have a wealth of formatting functionality built into them. 

In this technique, I show you how to work with the formatting functional- 
ity of the stream classes, how to extract data from a stream, and how to 
output columns and change floating point precision for data. 

Working With Streams 

In order to understand just how a stream component can be used in your 
application to save time and effort, let's take a look at a simple example 
of a stream being used in an application. In this case, we will create some 
data in our program, and then output that data to the user. In addition, 
we will examine how to extend the stream class by creating our own out- 
put control. 
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f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
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ile is named ch40 . cpp, 
although you can use whatever you choose. 

2, Type the code from Listing 40-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 40-1: Using Streams 

#i include <stdio.h> 
#i include <iostream> 
#include <sstream> 
#include <vector> 

using namespace std; 

void Pri ntDoubl eRow( int numEl ements , double 
*dArray, ostream& out ) 

{ 

// First, set up some elements of the 
ostream . 

// Set the output floating point preci- 
sion to 2 decimal places, 
out . preci si on (4 ) ; 

// Only show the decimal point if it is 

not a whole number, 
out << showpoint; 



vector<A> : : i terator iter; 
for ( iter = dVector . begi n ( ) ; iter 
dVector . end ( ) ; ++iter ) 

{ 

out.width(8) ; 
out << (*iter) ; 

} 

out << endl ; 
return out; 



int maind'nt argc, char **argv) 
I 

doubl e dArray [20] ; 
int nCount = 0; 

// See whether they gave us any on the 

command line, 
if ( argc > 2 ) 
{ 

for ( int i=l; i<argc; ++i ) 
( 

stringstream str; 
double number; 

str . setf ( i os : : f i xed , 

std : : i os_base : :floatfield) ; 
str.width(O) ; 
str . preci si on (4 ) ; 
str << argv[i ] ; 
str >> number; 
dArray [nCount] = number; 
nCount++; 



for ( int i=0; i <numEl ements ; ++i ) 

{ 

// Set each column to be 8 spaces. 

out.width(8) ; 

// Output the float. 

out << dArray[i ] ; 



el se 



// Prompt the user for input, 
bool bDone = false; 
while ( IbDone ) 



out << endl 



! 



template < class A > 
ostream& operator<<( ostream& out, 
vector< A >& dVector ) 

I 



char szBuffer[80] ; 

cout << "Enter a number (or a 

dash (*) to quit) : " ; 
memset( szBuffer, 0, 
cin >> szBuffer; 
if ( szBuffer[0] == 
bDone = true; 

el se 



); 



) 
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stri ngstream str; 
double number; 
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setf ( i os : : f i xed , 

i os_base : : f 1 oat- 
el d) ; 
str.width(O) ; 
str.precision(4) ; 
str << szBuffer; 
str >> number; 
dArray [nCount] = number; 
nCount++; 



3. Save the source-code file in the code editor and 
close the editor application. 

4. Compile the application in your favorite com- 
piler, on your favorite operating system. 

If you have done everything right, when you run the 
application with the following command-line input: 

12 3 4 

you should see the following output from the appli- 
cation on the console window: 



Pri ntDoubl eRow( nCount, dArray, 
cout ) ; 

// Now display it as a vector. 

vectoK double > dVector; 

for ( int i=0; KnCount; ++i ) 

dVector . i nsert( dVector . end( ) , 
dArray [i ] ) ; 
cout << "Vector: " << endl ; 
cout << dVector << endl ; 



Let's take a look at what is going on here. First, 
we create a standard array of double values and 
put data received from the user into the array. 
That array is then printed out using the standard 
stream class (see -* 1). Next, we are creating an 
"array" using the Standard Template Library 
vector class (see -* 2). We then print that vec- 
tor out using a stream shown at -* 3. But wait, 
how does this work? Vectors are not among the 
standard supported types for streams. If you 
look at the templated function marked with -* 4, 
you will see that we have created an overloaded 
operator that takes a vector object and outputs 
it to a stream. The compiler will match up our 
overloaded operator along with the streaming of 
the vector, and make sure that it all works prop- 
erly. Note also the use of the width and precision 
methods of the stream class to set the output 
width of each column in the vector properly, and 
only output the right number of decimal points. 



$ ./a.exe 12 3 4 
1.000 2.000 

Vector : 

1.000 2.000 



3.000 4.000 



3.000 4.000 



As you can see, the output is the same for both the 
array and vector classes. We can also see that the 
width of the columns is fixed at eight characters, as 
we specified in the width method of the stream. 
Finally, note that the number of decimal points is 
fixed at three for each entry, once again as specified 
in the preci si on method. 

Alternatively, you can enter the data at the prompt. 
To do so, run the program with no input arguments, 
and then enter the values when prompted from the 
user. In this case, you should see the following out- 
put from the program in the console window: 



$ ./a.exe 

Enter a number (or a dash (*) to quit) 

Enter a number (or a dash (*) to quit) 

Enter a number (or a dash (*) to quit) 

Enter a number (or a dash (*) to quit) 

Enter a number (or a dash (*) to quit) 

1.000 2.000 3.000 4.000 
Vector : 

1.000 2.000 3.000 4.000 



The output from the program is the same, the only 
difference is how the data got into the system. Note 
again that the width of the columns is still fixed 
and the number of decimal points is still what we 
specified. 
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Processing files in C++ is really the same as processing any other 
sort of input or output. Unlike similar functions in C, however, the 
file-processing functions in C++ allow you to use the same code for 
processing data — from either the keyboard or a file. This generality 
makes it considerably easier to write code that is easy to test, run, and 
maintain. And, of course, when code is faster to write and easier to test, 
it saves you time in the project. 



If you use stream classes instead of C-style file functions to access 
data, you will find the code quicker to write and test — and errors 
easier to trap. See Technique 40 for more on using stream classes. 




This technique shows you how to use the file-stream classes to read in — 
and process — a simple preferences file. I also tell you how this method 
compares to the old style of doing things, so that you can easily drop in 
this code wherever you are using the older C-style functions. 



f. In the code editor of your choice, create a new file to hold the code 
for the implementation of the source file. 

In this example, the file is named ch41 . cpp, although you can use 
whatever you choose. 

2. Type the code from Listing 41-1 into your file. 

Better yet, copy the code from the source file on this book's compan- 
ion Web site. 



Listing 41-1: The File-Reading Class 

#include <stdio.h> 
#include <string.h> 



#i ncl ude 
#i ncl ude 
#i ncl ude 
#i ncl ude 
#i ncl ude 



<f stream> 
<i os> 

<i ostream> 
<stri ng> 
<vector> 
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using namespace std; 

// The old fashioned way 
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char *strName; 
char *strValue; 

void I n i t ( ) 
{ 

strName = NULL; 
strValue = NULL; 

} 

publ i c : 

Entry ( ) 
{ 

InitO ; 

} 

Entry( const char *name, const char *value ) 
{ 

InitO ; 

setNamet name ) ; 
setVal ue ( value ) ; 

} 

Entry( const Entry& aCopy ) 
{ 

InitO; 

setName( aCopy . strName ); 
setValuet aCopy . strVal ue ); 

-Entry O 
{ 

if ( strName ) 

delete [] strName; 
if ( strValue ) 

delete [] strValue; 

I 

Entry operator=( const Entry& aCopy ) 
{ 

setNamet aCopy . strName ); 
setValuet aCopy . strVal ue ); 
return *this; 

void setNamet const char *name) 
{ 

if ( strName ) 

delete [] strName; 
strName = new char[strl en(name)+l ]; 
strcpyt strName, name ); 

) 

void setValuet const char *value ) 

(continued) 
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Listing 41-1 (continued) 



l_ ^ ^ if ( strValue 
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Value ) 

strVal ue ; 
w char[strlen 

(value)+l ]; 
strcpyt strValue, value ); 



szValue[strlen(szValue)-l] 
= 0; 

Entry e( szName, szValue ); 
if ( nPos < nMaxEntries ) 

{ 

array[ nPos ] = e; 
nPos ++; 



const char *getName( void ) 

{ 

return strName; 

} 

const char *getValue( void ) 

{ 

return strValue; 



}; 



bool OpenFi 1 eAndReadOl d ( const char 
*strFi 1 eName , Entry* array, int 
nMaxEntries, int *numFound ) 

{ 

FILE *fp = fopen ( strFileName, "r" ); 
if ( fp == NULL ) 
return false; 
int nPos = 0; 
while ( !feof(fp) ) 
{ 

char szBuffer[ 257 ] ; -* 1 

memset( szBuffer, 0, 256 ); 
if ( fgets( szBuffer, 256, fp ) == 
NULL ) 
brea k ; 

// Look for the position of the '=' 
sign. 

char *str = strstr(szBuffer, "="); 
if ( str ) 

{ 

// First, get the name, 
char szName[256] ; 
memset( szName, 0, 256 ); 
strncpy ( szName , szBuffer, 

strl en( szBuffer ) -strl en( str ) ); 

// Now, get the value, 
char szVal ue[256] ; 
memset( szValue, 0, 256 ); 
strncpy ( szVal ue , str+1, 

strl en ( str ) - 1 ) ; 
if ( szVal ue[strl en ( szVal ue ) -1 ] 

== '\n' ) 



} 

*numFound = nPos; 
fcl ose(fp) ; 
return true; 



The code in Listing 41-1 does things the old- 
fashioned way (C-style), using file-based func- 
tions. Trying it with streams creates reusable 
operators along the way. That's next. 

3. Now, append the code in Listing 41-2 to the 
source file using your favorite source-code 
editor. 

Listing 41-2: Using Streams for File Reading 

// Various operators used by the 
appl i cati on . 

ifstream& operator<<( string& sin, ifstream& 
in ) ->3 

I 

while ( ! i n . eof ( ) ) 

{ 

char c ; 

i n . get ( c ) ; 

if ( in. fail ( ) ) 

return in; 
sin += c ; 
if ( c == '\n' ) 

return in; 



return in; 
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string operator-( string& sin, 
char cln ) 
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lengthO; ++i ) 



sOut += sln[i ] ; 
return sOut; 



bool OpenFi 1 eAndReadNew( const char 
*szFi 1 eName , std : : vector< Entry >f 
entries ) 



Entry e(name.c_str( ) , 

val ue . c_str( ) ) ; 
entries . insert( entri es . end ( ] 



e ); 



i n . cl ose( ) ; 
return true: 



if stream in; 

i n . open ( szFi 1 eName ) ; 

if ( in.failO ) 
I 

pri ntf ( "Unabl e to open file %s\n", 

szFi 1 eName ) ; 
return false; 



// Process the file 
while ( h'n.eofO ) 

{ 

// Get an input 
string sLine = " 
sLine << in; 



// Skip comments 
if ( sLine.lengthO && 
== '#' ) continue; 



// Remove all carriage 

line feeds 
s Li ne = s Li ne - ' \n ' ; 
sLine = sLine - ' \ r ' ; 



// Now, extract the pieces 
int ePos = s Li ne . f i nd_f i rst_ 

( ' = ' , 0) ; 
if ( ePos != string: rnpos ) 
{ 

// Copy the name 
string name = 

sLine.substr(O.ePos) ; 
string value = 

sLine.substr(ePos+l) ; 



sLine[0] 



returns and 



of 



4. 



As you can see, the code is much easier to 
understand and maintain in the stream version. 
Readability is important in coding because it 
takes less time for the maintenance programmer 
to read and understand your objective. The 
stream versions of the code form their own 
description of what we are trying to do, improv- 
ing on the confusing C-style functions. More 
importantly, if we want to test the functions from 
the keyboard, it is trivial to pass in the standard 
input object instead of a file. The code can cope 
with both types of input. 

To understand just how simple the stream ver- 
sion is compared to the older version, take a 
look at two similar segments of the code. The 
line marked -* 1 in the original listing shows 
how we read a line in from the input source. The 
corresponding line in the updated stream ver- 
sion is marked -* 2. Note that the stream version 
is not only smaller and easier to read, but also it 
handles problems the original code did not. For 
example, the string class can handle an almost 
infinite number of characters, whereas the buffer 
used in the original code is fixed in size. 
Likewise, the stream version automatically 
enters the number of characters into the string 
class, which makes checking for blank lines sim- 
ple. Finally, checking for substrings in stream 
classes is considerably easier than using the 
clunky old strstr function that required you 
to check for NULL returns and end of string 
comparisons. 

Save the source code as a file in the code 
editor. 
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Notice the operators that are defined in this 
block of code (shown at the lines marked -* 3 
and -* 4). These provide a standard way to 
rarifl*<e **4P|i]p-li** of a file into a string 
^|ct/-|aiy[^aSt*|efficient way to remove a 
characterfrom a string. The nicest thing about 
C++ operators is that they can be defined 
externally to the class they manipulate, so they 
don't require that the original classes be modi- 
fied. This is a good way to extend functionality 
without derivation or modification. 



Testing the File- Reading Code 

After you have created the file-reading functionality, 
you should create a test driver that not only ensures 
that your code is correct, but also shows people 
how to use your code. 

The following steps show you how to create a 
test driver that illustrates how the two methods 
for inputting data (OpenAndReadFi 1 eOl d and 
OpenAndReadFi 1 eNew) are used — and what the 
output of each will be. 

In the code editor of your choice, reopen 
the existing file to hold the code for your test 
program. 

In this example, I named the test program 

ch 41.cpp. 

2. Append the code from Listing 41-3 into your 
file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 41-3: The File-Read Test Driver 

int main( int argc, char **argv ) 

{ 

if ( argc < 2 ) 

{ 

pri ntf( "Usage ch5_3 f i 1 ename\n" ) ; 
exit(l) ; 



Entry entriesl[50] ; 
int num = 0 ; 



printf ( "01 d Way : \n" ) ; 
if ( 0penFileAndRead01d( argv[l], 
entriesl, 50, &num ) == false ) 

{ 

pri ntf( " Error processing file %s\n" 

argv[l] ); 
exit(l) ; 

} 

for ( int i=0; i<num; ++i ) 
( 

cout << "Entry " << i << endl ; 
cout << "Name: " << 

entriesl[i ] .getName( ) << endl; 
cout << "Value: " << 

entri esl[i ] . getVal ue( ) << endl; 



pri ntf ( "New Way : \n" ) ; 
std::vector< Entry > entries2; 
if ( OpenFi 1 eAndReadNew( argv[l], 
entries2 ) == false ) 

1 

pri ntf (" Error processing file %s\n" 

argv[l] ); 
exit(l) ; 

I 

std::vector< Entry >::iterator iter; 
int nPos = 0; 

for ( iter = entri es2 . begi n () ; 
iter != entri es2 . end () ; ++iter ) 
{ 

cout << "Entry " << nPos << endl; 
cout << "Name: " << 

(*iter) .getNamet ) << endl; 
cout << "Value: " << 

(*iter) .getVal ue( ) << endl; 
nPos ++; 



This simple program just allows us to read in a 
test file in two different ways, using both the old- 
style C functions and the new-style stream func- 
tions. We then print out the values to compare 
them. Note that the old-style function requires 
that we use a fixed-size array, while the stream 
version uses the newer vector class to allow for 
an almost-infinite number of entries. 

3. Save the source-code file and close the source 
editor application. 
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^> the lestw^iver, we need some input 
rtAl^df it^l foSp^^ess. Let's create a simple 
telt file that contains data that we can read in to 
compare the old-and new-style functions of input 
and output. 

f. In the code editor of your choice, create a text 
file for testing the application. 

In this case, I used the name test . txt for the 
test file. 

2. Type the following text into the test file: 

Configl=A config string 

Config2=100 

Conf i g3=Another line 

# This is a comment 
Config4=A.$5 

3. Save the test file and close the code-editor 
application. 

4. Compile and run the program with your 
favorite compiler and operating system. 

If you have done everything properly, you should 
see the following output from the program on your 
console window: 

$ ./a.exe test. txt 

Old Way: 5 

Entry 0 

Name: Configl 

Value: A config string 

Entry 1 

Name: Config2 



Value: 
Entry 
Name : 
Value: 



100 



Conf i g3 
Another 
Entry 3 
Name: Config4 
Value: A. $5 
New Way: 
Entry 0 
Name : 
Val ue 



Conf i gl 
A config string 



Entry 1 
Name: Config2 
Value: 100 
Entry 2 
Name: Config3 
Value: Another line 
Entry 3 
Name: Config4 
Value: A. $5 

As you can see by the output of our program, both 
the old and new ways of processing the data work 
the same. All of the entries shown under the 01 d Way 
output line were read in using the old-style C func- 
tions, while the output shown under the New Way out- 
put line were read in using the new-style streams. By 
using this simple program, therefore, we can easily 
convert old-style applications to the new-style func- 
tions quickly and easily, saving time and effort. 

No functional difference exists between the old-style 
C functions and the new-style C++ streams. To see 
this, compare the lines shown at -» 5 and at -> 6. 
Leaving out the additional operators that can be 
reused anywhere, however, makes the new-style 
code that handles streams considerably smaller and 
easier to read; by comparison, the old-style code is 
cumbersome and confusing. 
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There are a lot of ways to store data in file systems. One of the most 
popular is a standard delimited file, in which the individual fields of 
the records are separated by known delimiters. There are numer- 
ous examples of this, from comma separated values (CSV) to XML files 
to fixed-size records that include null bytes. The capability to load delim- 
ited data into your application is very valuable — and it makes your 
application considerably easier to use. 



Extracting the input and output of data formats into separate classes 
will not only make the classes more reusable across applications, it 
will also save you lots of time when trying to load known formats into 
new applications. 



This technique builds some generic classes that aid loading and parsing 
delimited files. I have to make a few assumptions here, although each of 
these assumptions is fairly easy to adapt if you need to change the logic. 
The assumptions are as follows: 

*>* The files contain only delimiters that separate fields. That is, no fields 
in the file contain delimiters. 

The records exist one per line. This is really just a convenience; it 
would be easy enough to check for an end-of-record signature other 
than the end-of-line character. 



The fields can vary in size. 



Reading Delimited Files 

Because the need to read delimited files is such a common problem in 
the software development world, it makes sense to build a generic 
method for reading them. By doing this, we save a lot of time because we 
are able to move the code to read the files from project to project. For 
example, you can create a generic class that can be used to read any sort 
of delimited files and test it with a variety of input. 
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f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
^source filg 

i t e id p^^^ile is named ch42 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 42-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 42-1: Reading a Delimited File 

#include <stdio.h> 
#i include <string> 
^include <vector> 
#i include <iostream> 
#include <fstream> 



for ( int i=0; 
i<strlen(delimiterList); ++i ) 
{ 

_del i mi ters . i nsert ( _del i mi ters . 
end(), del imi terLi st[i ] ); 



Delimiterst const Delimiters& aCopy ) 
{ 

Copy ( aCopy ) ; 

I 

Delimiters operator=( const Delimiters& 
aCopy ) 

{ 

Copy ( aCopy ) ; 

I 

virtual ~Del imiters(void) 



// Avoid having to type out std:: for all 
// STL classes, 
using namespace std; 

// This class manages a list of delimiters, 
cl ass Del imiters -* 1 

{ 

private: 

// Array of possible delimiters. Use a 
vector , 

// since the characters could include 
NULL byte 

// or other characters that string can't 
handl e . 

vector< char > _delimiters; 

protected : 

virtual void Copy ( const DelimitersS 
aCopy ) 

{ 

vector<char> : : const_i terator iter; 
for ( iter = 

aCopy ._del i mi ters . begi n ( ) ; iter != 
aCopy ._del i mi ters . end( ) ; ++iter ) 
_del i mi ters . i nsert ( _del i mi ters . 
end(), (*iter) ); 

} 

public: 

Del imiters(void) 



Delimiterst const char *del imi terLi st ) 

{ 



// Clear out the entire list. 

virtual void ClearO 

{ 

_del imi ters . erase ( _del imi ters . 
beginO, _del imiters .end( ) ); 

) 

// Add a delimiter to the list, 
virtual void Add( char c ) 
{ 

_delimiters.insert( _delimiters. 
end( ) , c ) ; 

I 

// See whether a given character is in 

the list, 
virtual bool Containst char c ) 
{ 

vector<char> : : const_i terator iter; 
for ( iter = _del i mi ters . begi n () ; 
iter != _del i mi ters . end( ) ; ++iter ) 
if ( c == (*iter) ) 
return true; 
return false; 

} 

// Remove a given delimiter, 
virtual bool Removet char c ) 
{ 

vector<char> :: i terator iter; 
for ( iter = _del i mi ters . begi n () ; 
iter != _del i mi ters . end( ) ; ++iter ) 
if ( c == (*iter) ) 
{ 

(continued) 
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_del i mi ters . eraset iter ); 
return true; 



// This class manages the data for a given row of a 
// delimited file. 

class DelimitedRow -* 2 

{ 

private: 

vector< string > _columns; 
protected : 

virtual void Copy( const Del imi tedRow& aCopy ) 



vectoKstri ng> : : const_i terator iter; 

for ( iter = aCopy ._col umns . begi n ( ) ; iter != aCopy ._col umns . end ( ) ; ++iter ) 
_col umns . i nsert ( _col umns . end () , (*iter) ); 



publ 



i c : 

Del imitedRow(void) 

Del imitedRow( const char *col ) 

Add( col ); 
virtual ~Del imi tedRowt ) 

virtual void Add( const char *col ) 

_col umns . i nsert( _col umns . end () , col ); 

nt NumColumns( void ) 

return _col umns . si ze( ) ; 

string getColumn( int index ) 

if ( index < 0 || index > NumCol umns( )-l 

return stri ng( " " ) ; 
return _col umns[i ndex] ; 
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II This class will handle a single delimited file, 
class Del imitedFi 1 eParser -> 3 

irfv3\e: 

1j r CJLJI\^ _fileName; 

relTUfff^TS _delim; 
if stream _in; 
vector<Del imitedRow> _rows; 
protected : 

virtual void Copy( const Del imitedFi 1 eParser& aCopy ) 

{ 

_fileName = aCopy ._f i 1 eName ; 
_delim = aCopy ._del im; 

vector<Del imitedRow>: : const_i terator iter; 

for ( iter = aCopy ._rows . begi n ( ) ; iter != aCopy ._rows . end ( ) ; ++iter ) 
_rows . i nsert ( _rows.end(), (*iter) ); 

} 

virtual void _ParseLine( string sin ) 

I 

// Given a delimiter list, and an input string, parse through 
// the string. 
DelimitedRow row; 
string s C o 1 = " " ; 

for ( int i=0; i <s In . 1 ength ( ) ; ++i ) 



publ 



{ 

if ( _del im. Contai ns ( sln[i] ) ) 
{ 

row.Addt sCol.c_str() ); 
sCol = ""; 

} 

el se 

sCol += sln[i]; 

) 

row.Addt sCol.c_str() ); 

_rows . i nsert ( _rows.end(), row ); 



c : 

Del imitedFileParser(void) 



Del imi tedFi 1 eParser ( const char *fileName, const char *delimiters 
: _delim( delimiters ) 

0pen( f i 1 eName ) ; 

Del imi tedFi 1 eParser ( const Del imi tedFi 1 eParser& aCopy ) 

Copy ( aCopy ) ; 



(continued) 
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vi rtual -Del imitedFi 1 eParser( ) 
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virtual bool Open( const char 
*fileName ) 

{ 

_fileName = fileName; 
_in.open( _f i 1 eName . c_str ( ) ); 
return !_in. fail ( ) ; 

) 

vi rtual bool Parset ) 

{ 

// Make sure the file is open, 
if ( _i n . fail ( ) ) 

{ 

return false; 

} 

while ( !_i n . eof ( ) ) 

{ 

string sin = " " ; 

while ( !_i n . eof ( ) ) 

( 

// Get an input line. 

char c ; 

_in.get(c) ; 

if C _in.fail C ) ) 

brea k ; 
if ( c !- '\r' && c !- 
•\n' ) 

sin += c ; 
if ( c == '\n' ) 

brea k ; 

1 

// Parse it. 
if ( s In . 1 ength ( ) ) 
_ParseLine( sin ) ; 



return true; 

} 

i nt NumRows ( ) 

{ 

return _rows . si ze( ) ; 

} 

Del imi tedRow getRow( int index ) 

{ 

if ( i ndex < 0 | | i ndex >= 



NumRows () ) 

throw "getRow: index out of 
range" ; 
return _rows[index] ; 



This code implements a generic parser and con- 
tainer of delimited files. By specifying the delim- 
iter between fields, the end-of-record indicator, 
and the source filename, you can then use this 
class to read in and retrieve all of the individual 
fields in the file. 

As you can see from the code, the entire applica- 
tion is made up of three classes, each of which 
manages a specific part of the process. The 
process has three parts: file management (shown 
at -» 3), data storage (shown at -> 2), and delim- 
iter management (shown at -* 1). 

3. Save the source file in the source-code editor 
and close the editor application. 



Always separate the individual components of 
a process into separate classes. That way you 
can easily modify one piece of the process 
without affecting the rest of the system. More 
importantly, you can reuse smaller compo- 
nents in other applications without having to 
pull in the entire system. 




Testing the Code 



After you have created the functionality, you should 
create a test driver that not only ensures that your 
code is correct, but also shows people how to use 
your code. 

The following steps show you how to create a test 
driver that illustrates how the file parser is used — 
and what the output will be. 

In the code editor of your choice, reopen 
the existing file to hold the code for your test 
program. 
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In this example, I named the test program 

ch42 . cpp. 
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from Listing 42-2 into your 



Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 42-2: The Delimiter Test Driver 

int maintint argc, char **argv) 

{ 

if ( argc < 2 ) 

{ 

pri ntf( "Usage ch5_2 
<del i mi tedFi 1 e>\n" ) ; 
exit(l) ; 

} 

Del imitedFileParser fileParser( argv[l], 



f i 1 eParser . Parset ) ; 

printf("%d Rows found\n", 

f i 1 eParser . NumRows ( ) ); 
for ( int i=0; i <fi 1 ePa rser . NumRows () ; 

++i ) 

{ 

Del i mi tedRow row = 

fileParser. get Row ( i ) ; 
pri ntf ( " Row: %d\n" , i ) ; 
for ( int j=0; j <row . NumCol umns ( ) ; 

++J ) 

pri ntf ( "Col umn %d = [%s]\n", j, 
row . getCol umn( j ) . c_str ( ) ); 



3, Save the source-code file and close the code- 
editor application. 

4. Create a test file for testing the application in 
the text editor of your choice. 

This file is used for input to the application and 
contains the delimited records. 

In this case, I used the name 
test_del i mi ted . txt for the test file. 



5. Type the following text into the test file: 

Line 1: Col umn 2: This is a 

test:100:200:300 
Line 2:Column 2:This is another 

test:200:300:400 

6. Save the test file and close the code-editor 
application. 

7[ Compile and run the program with your 
favorite compiler and operating system. 

If you have done everything properly, you should 
see the following output from the program on your 
console window: 



$ . /a . i 


2xe 


test_del i mi ted . tx 


2 Rows 


found 


Row: 0 






Col umn 


0 


= [Line 1] 


Col umn 


1 


= [Column 2] 


Col umn 


2 


= [This is a test] 


Col umn 


3 


= [100] 


Col umn 


4 


= [200] 


Col umn 


5 


= [300] 


Row : 1 






Col umn 


0 


= [Line 2] 


Col umn 


1 


= [Column 2] 


Col umn 


2 


= [This is another 


Col umn 


3 


= [200] 


Col umn 


4 


= [300] 


Col umn 


5 


= [400] 



As you can see from the output, the parser properly 
determines that there are two records in the test file 
that we gave it for input. Each of the input lines con- 
tains five columns of data, separated by a colon (:) 
character. By telling the parser that the delimiter is a 
colon, it then breaks each line into individual 
columns and returns that data to the user as a 
Del i mi tedRow object in a vector of such objects. 

This class can now be moved from project to proj- 
ect, in any situation where we need to read in a 
delimited file and use the individual components of 
each record (or line) in the file. This saves us time in 
implementing the functionality over and over, and 
saves us effort because the code will already be 
debugged. 
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The current buzzword of the programming world is XML and XML 
compatibility. XML, which stands for extended Markup Language, 
is really just a variant of the SGML display language (from which 
HTML was also derived) that has been optimized for data storage instead 
of for display. 

It's no surprise that the capability to output data as XML code has 
become very important in the programming world. Because the structure 
of XML is so much like the structure of C++ — in terms of hierarchical 
display and classes and attributes — you can easily use XML to store and 
restore data to and from C++ classes. 

The general format of an XML structure is as follows: 

<xml> 

<structure-name> 
<el ement-name> 

va 1 ue 
</el ement- name> 
</ structure- name) 
</xml> 



As you can see, it looks very much like a C++ class structure with a struc- 
ture name as the name of the class and an element name as the name of 
each piece of member data of that class. Here's an example: 

Class Foo 

{ 

int x; // We can think of the semicolon as </int> 
// And so forth 

) ; 



In the above class definition, we have an object name (class Foo), an ele- 
ment (i nt), and a value for that element (x). This maps quite directly into 
the XML general schema. The initial definition was a true XML object, 
whereas this definition is a true C++ class. Yet you can see how one maps 
to the other. We could write the above class as 
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<Foo> 

<int> x 
</Foo> 



</int> 



cffHsjie|"qpe^yo map quite well. By stor- 
; data in XML format, we make it possible to read 
the data not only into C++ applications, but also into 
any other applications that understand the XML for- 
mat, such as databases. Storing data in a known, 
standard format saves time by eliminating the need 
to write translators for your data formats, and by 
allowing you to use existing applications with your 
data. In this example, we will look at how to write 
out a C++ class in XML format, and then how to read 
back in that XML data to a C++ class. 



Creating the XML Writer 

The first step in the process is to add the ability to 
write out the data for our class in XML format. We 
will call the element that does this processing an 
XMLWri ter object. Let's look at a generic way to cre- 
ate an XMLWri ter that will save us time by allowing 
us to apply this functionality to all objects in our 
system. 

f m In the code editor of your choice, create a new 
file to hold the code for the definition of the 
class. 

In this example, the file is named ch43 . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for the 
needed automation object. 

2. Type the code from Listing 43-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 43-1: The XML Writer Class 

#include <stdio.h> 

#i include <string> 

#include <vector> 

#i include <f stream) 



using namespace std; 

// Class to manage the storage of the XML 
data . 

class XMLElement 
{ 

private: 

string _name; 
string _value; 

vector< XMLElement > _subEl ements ; 
protected : 

virtual void I n i t ( ) 
{ 

_name = " " ; 

_val ue = " " ; 

_subEl ements . erase ( 
_subEl ements . begi n ( ) , _subEl ements . end( ) 
) ; 
I 

virtual void Copy( const XMLElement& 

aCopy ) 

I 

setNamet aCopy .getNamet ) .c_str( ) ); 
setValue ( aCopy . getVal ue( ) . c_str ( ) 

) ; 

vector< XMLElement >::const_ 

iterator iter; 
for ( iter = 

a Copy ._subEl ements . begi n ( ) ; 

iter != 
a Copy ._subEl ements . end( ) ; 
++iter ) 
_subEl ements .insert 
( _subEl ements . end( ) , (*iter) ); 
I 

publ i c : 

XMLElementt void ) 
{ 

Init( ) ; 

I 

XMLElement( const char *name, const 
char *value ) 

{ 

setNamet name ) ; 
setVal ue( value ) ; 

} 

XMLElement( const char *name, int 
value ) 

{ 

(continued) 
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setName( name ) ; 
char szfiuf fer[10] ; 

fer , "M" , val ue ) ; 
uf f er ) ; 



l_ ^ ^ char szputter 
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XMLElement( const char *name, double 
value ) 

{ 

et N name ) ; 
char szBuffer[10] ; 
spri ntf ( szBuf f er , "%lf", value ); 
setVal ue( szBuffer ) ; 



XMLElement( const XMLElement& aCopy ) 

{ 

Copy ( aCopy ) ; 

} 

virtual -XMLEl ement ( ) 



XMLElement operator=( const XMLElement& 
aCopy ) 

{ 

Copy ( aCopy ) ; 
return *this; 



// Accessors 

void setName( const char *name ) 

{ 

_name = name; 

) 

void setValue( const char *value ) 

{ 

_val ue = val ue ; 

} 

string getNamet void ) const 

{ 

return _name; 

} 

string getValue( void ) const 

{ 

return _val ue ; 



// Sub-element maintenance, 
void addSubEl ement( const XMLElementS 
anElement ) 

{ 

_subEl ement s . insert ( _subEl ement s . 
end( ) , anEl ement ) ; 

I 

int numSubEl ements ( void ) 

{ 

return _subEl ements . si ze( ) ; 

} 

XMLElementS getSubEl ement( int index ) 
I 

if ( i ndex < 0 | | i ndex >= 
numSubEl ements ( ) ) 

throw "getSubEl ement : index out 
of range" ; 
return _subEl ements[ index ]; 



// Class to manage the output of XML data. 

class XMLWriter 

I 

pri vate : 

ofstream _out; 
publ i c : 

XMLWriter( void ) 

{ 
} 

XMLWriter( const char *fileName ) 
{ 

_out.open(fileName) ; 

if ( _out.fail() == false ) 

I 

_out << "<xml>" << endl ; 



XMLWriter( const XMLWriterS aCopy ) 
( 

} 

virtual -XMLWriterO 

{ 

if ( _out.fail() == false ) 

{ 

_out << "</xml >" << endl ; 

} 

_out . cl ose( ) ; 

I 
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void setFileNamet const char *fileName ) 

I 

out . open ( f i 1 eName ) ; 

== false ) 



"<xml>" << endl 



virtual bool Writet XMLElement& aRoot ) 

{ 

if ( _out.fail () ) 
return false; 



Testing the XML Writer 

After you create the class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 

The following steps show you how to create a test 
driver that illustrates various types of data ele- 
ments, and will illustrate how the class is intended 
to be used. 



// First, process the element. 
_out << "<" << 
aRoot . getName( ). c_str( ) << ">" << endl; 

// If there is a value, output it. 
if ( aRoot . getVal ue( ). 1 ength ( ) 
!= 0 ) 

_out << aRoot. getVal ue( ) .c_str( ) 
<< endl ; 

// Now, process all sub-elements, 
for ( int i=0; 
i <aRoot . numSubEl ements ( ) ; ++i ) 

Writet aRoot. getSubEl ement ( i ) ); 

// Finally, close the element. 
_out << "</" << 
aRoot . getName( ). c_str( ) << ">" << endl; 



This listing illustrates the basics of our XML 
writing functionality. Each element of an XML 
object will be stored in an XMLE1 ement object. 
The writer (XMLWri ter class) then processes 
each of these elements to output them in valid 
XML format. 

3. Save the source-code file and close your editor 
application. 

4. Compile the application with your favorite com- 
piler, on your favorite operating system, to ver- 
ify that you have made no errors. 



In the code editor of your choice, reopen the 
source file for your test program. 

In this example, I named the test program 

ch43 . cpp. 

2. Type the code from Listing 43-2 into your file 



Better yet, copy the code from the source file on 


this book's companion Web 


site. 


Listing 43-2: The XMLWriter Test Code 


class XmlTest 




1 

pri vate : 




int iVal ; 




stri ng sVal ; 




doubl e dVal ; 




publ i c : 

XmlTest( ) 
1 





iVal = 100; 
sVal = "Test" ; 
dVal = 123.45; 



~XmlTest( ) 



XMLElement getXML(void) 

{ 

XMLElement eC'XmlTest 
e . addSubEl ement ( 

XMLElementCiVal", 
e . addSubEl ement ( 

XMLElementC'sVal", 

c_str()) ); 
e . addSubEl ement ( 

XMLElementC'dVal 
return e; 



'); 



iVal 
sVal 

dVal 



(continued) 
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Listing 43-2 (continued) 



void TestWriter2(void) 
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XmlTest xt; 
int count; 
publ i c : 

Xml SuperCl ass ( ) 
{ 

count = 1; 

} 

~Xml SuperCl ass ( ) 



Xml SuperCl ass xsc; 
XMLWriter writer( "test 2. xml " ) : 
XMLElement e = xsc . getXMU ) ; 
writer. Write( e ) ; 



int mai n ( ) 



TestWri terl ( ) ; 
Testwriter2( ) ; 
return 0; 



XMLElement getXMK ) 
{ 

// First, do ourselves 
XMLElement e( "Xml SuperCl ass" , ' 
e . addSubEl ement ( 

XMLE1 ement( "count" , count) ): 

// Now the sub-object 

e . addSubEl ement( xt.getXMLO ) 

return e; 



void TestWri terl ( voi d ) 

{ 

XMLElement el el ( "Sub- El ementl " , "123"); 
XMLElement el e2( "Sub- El ement2" , "234"); 
XMLE1 ement subel el ("Sub-Sub- El ementl " , 
"345") ; 

XMLE1 ement subel e2( "Sub-Sub-El ement2" , 
"456") ; 

XMLElement rootC'Root", ""); 

el el . addSubEl ement( subelel ); 

el e2 . addSubEl ement( subele2 ); 

root . addSubEl ement ( elel ); 

root . addSubEl ement( ele2 ); 

XMLWri ter wri ter ( " test . xml " ) ; 
writer. Write( root ) ; 



3, Save the source-code file and close the editor 
application. 

4. Compile the application, using your favorite 
compiler on your favorite operating system. 

If you have done everything properly, running the 
application results in the creation of two files, 
test . xml and test2 . xml . If you look at the contents 
of these files, you should see the following: 

test . xml : 
$ cat test. xml 
<xml> 
<Root> 

<Sub- El ementl> 

123 

<Sub-Sub-El ement 1> 

345 

</Sub-Sub-El ement 1> 
</Sub- El ementl> 
<Sub- El ement2> 
234 

<Sub-Sub-El ement2> 
456 

</Sub-Sub-El ement2> 
</Sub-El ement2> 
</Root> 
</xml> 
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test2 . xml : 

$ cat test2.xml 

<xml> 
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C/count> 
<XmlTest> 
<iVal > 
100 

</iVal > 

<sVal> 

Test 

</sVal> 

<dVal > 

123.450000 

</dVal > 

</XmlTest> 

</Xml SuperCl ass> 

</xml> 



4 

5 



If we look at the class hierarchy shown in the appli- 
cation source code, we see that the main class, 
Xml SuperCl ass (shown at -> 1), contains both stan- 
dard data elements (count, an integer) and embed- 
ded objects (Xml Test, shown at -> 2). In the XML 
output, we see these elements at the lines marked 
3 and -> 4. Note how the embedded class con- 
tains its own elements (shown at -* 5 in the output 
list) which are children of both the Xml Test and 
Xml SuperCl ass classes. 

The code shows that both cases work fine — the 
simple case of using the XMLE1 ement and XMLWriter 
classes, and the embedded case of outputting an 
entire C++ class with an embedded C++ object. 





Removing White 
Space from Input 



Although it might not seem like a big deal, dealing with white space 
in input from either files or the console can be a major pain in the 
neck for C++ programmers. After all, white space isn't empty; it 
has to be accounted for. When you want to store a user name in your 
database, for example, do you really want to store any leading and trail- 
ing spaces, tabs, or other non-printing characters? If you do so, the users 
will then have to remember to type those spaces in again whenever they 
log in to your application. While this might be a useful security condition, 
it seems unlikely that anyone would remember to add either leading or 
trailing spaces to a user name or password in an application. 

For this reason, if you give your code the capability to strip off leading 
and trailing spaces from a given string with no fuss — and return that 
string to the calling application — you save a lot of time and hassle. This 
technique looks at creating that exact capability. The following steps 
show you how: 

/. In the code editor of your choice, create a new file to hold the code 
for the implementation of the source file. 

In this example, the file is named ch44 . cpp, although you can use 
whatever you choose. 

2. Type the code from Listing 44-1 into your file. 

Better yet, copy the code from the source file on this book's com- 
panion Web site. 

Listing 44-1: The White Space Removal Code 

#include <string> 
#include <ctype.h> 

// Nobody wants to have to type std:: for 
// all of the SfL functions, 
using namespace std; 



Save Time By 

Stripping leading and 
trailing spaces from input 

Returning the modified 
string back to your 
application 

V Testing your code 
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string stri p_l eadi ng ( const string& sin ) 

{ 

string sOut; 



DropBmte 



leading spaces. 
= 0; 

while ( nPos < sln.lengthO ) 

if ( ! i sspacet s In[nPos] ) ) 

break; 
nPos ++; 



// Now we have the starting position of 
// the "real" string. Copy to the end... 
while ( nPos < sln.lengthO ) 

{ 

sOut += sIn[nPos] ; 
nPos ++; 



1 



// ...and give back the new string, 
// without modifying the input string, 
return sOut; 



string stri p_trai 1 i ng ( const string& sin ) 

{ 

stri ng sOut ; -* 1 

// Skip over all trailing spaces, 
int nPos = s In . 1 ength ( ) - 1 ; 
while ( nPos >= 0 ) 

{ 

if ( ! i sspace(sIn[nPos] ) ) 

break; 
nPos --; 

} 

// Now we have the ending position of 
// the "real" string. Copy from the 
// beginning to that position... 
for ( int i=0; i<=nPos; ++i ) 
sOut += sln[i ] ; 



// ...and give back the new string, 
// without modifying the input string, 
return sOut; 



} 



int maintint argc, char **argv ) 
{ 

if ( argc > 2 ) 
{ 

pri ntf ( " Removi ng Leading Spaces\n": 
for ( int i = 1; i < argc; ++i ) 
{ 

pri ntf (" Input String: [%s]\n", 

argv[i] ); 
string s = argv[i]; 
s = stri p_l eadi ng ( s ) ; 
pri ntf ( " Resul t String: [%s]\n". 

s . c_str( ) ) ; 

} 

pri ntf (" Removi ng Trailing 

Spaces\n" ) ; 
for ( int i = 1; i < argc; ++i ) 
1 

pri ntf (" Input String: [%s]\n", 

argv[i] ); 
string s = a r g v [ i ] ; 
s = stri p_trai 1 i ng ( s ); 
pri ntf (" Resul t String: [%s]\n". 

s . c_str( ) ) ; 

} 

pri ntf (" Removi ng both leading and 

trai 1 i ng\n" ) ; 
for ( int i = 1; i < argc; ++i ) 
{ 

pri ntf (" Input String: [%s]\n", 

argv[i] ); 
string s = a r g v [ i ] ; 
s = stri p_t r a i 1 i n g ( s t r i p_ 

leading(s) ); 
pri ntf (" Resul t String: [%s]\n". 

s . c_str( ) ) ; 



else 



(continued) 
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Listing 44-1 (continued) 



bool bDone = false; 
while (■ ! bDone ) 



^ wni le ■ iDuon 
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ffer[ 80 ] ; 
pri ntf( " Enter string to fix: "); 
gets ( szBuf f er ) ; 

pri ntf( " Input string: [%s]\n", 
szBuf f er ) ; 

// Strip the trailing carriage 

return . 
if ( st rl en ( szBuf f er ) ) 

szBuffer[strlen(szBuffer)-l] 
= 0; 

if ( ! strl en ( szBuf f er ) ) 
bDone = true; 

else 

( 

string s = szBuffer; 
s = stri p_l eadi ng( s ) ; 
pri ntf( "After removing 

leading: %s\n", s.c_str() ); 
s = stri p_trai 1 i ng( s ) ; 
pri ntf( "After removing 

trailing: %s\n", s.c_str() 

) ; 



return 0; 



3. Save the source-code file and close the editor 
application. 

4. Compile the application with your favorite com- 
piler on your favorite operating system. 

If you have done everything properly, and you run 
the program with the following command-line 
options, you should see the following output in your 
console window: 



$ ./a 

Removi 
Input 
Resul t 
Input 
Resul t 
Input 
Resul t 
Removi 
Input 
Resul t 
Input 
Resul t 
Input 
Resul t 
Removi 
Input 
Resul t 
Input 
Resul t 
Input 
Resul t 



this is a test " " hello 
goodbye" 
ng Leading Spaces 
String: [ this is 
[this is a 
hello ] 
o ] 



a test 
test 



is a test 
is a test] 
] 



Stri ng : 
String: [ 

String: [hel 
String: [ goodbye] 

String: [goodbye] 
ng Trai 1 i ng Spaces 
String: [ this 

String: [ this 
String: [ hello 

String: [ hello] 
String: [ goodbye] 
String: [ goodbye] 
both leading and trai 
String: [ th""' c n '° =■ +c 

String: [this 
String: [ hello ] 

String: [hello] 
String: [ goodbye] 
String: [goodbye] 



n g 



this is a 
is a test] 



ling 
test ] 



Stripping any trailing white space from a string is 
a simple endeavor. You just find the last white 
space character and truncate the string at that 
point. Stripping leading white space, on the other 
hand, is a more complicated problem. As you can 
see at the line marked -> 1 in the source listing, 
you must create a separate string to use for the 
return value of the stri p_l eadi ng function. This 
string is then built-up by finding the first non- 
blank character in the input string and then 
copying everything from that point to the end of 
the string into the output string. The output 
string is then returned to the calling application 
sans leading white space. 



In the output, we see that each string is input into 
the system, then the various white space characters 
in the front and back of the string are removed. In 
each case, the string is output to the user to view 
how it is modified. For example, if we look at the 
input line at -* 2, we see that it contains both lead- 
ing and trailing spaces. When the strip_leading 
function is applied, we get the result shown at -> 3, 
which is the same string with no leading spaces. 
When the stri p_t railing function is applied, we get 
the result shown at -* 4, which is the same string 
with no trailing spaces. Finally, we apply both of the 
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functions at the same time, and get the result shown 
at -> 5, which has neither leading nor trailing 
spaces 

)ication by typing in data 
from the prompt by running the application with no 
input arguments. Here is a sample of what the test 
looks like in that form: 



As you can see, input from either the command line 
or from user entries (whether from the keyboard or 
a file) can contain white space. This white space 
must be removed to look at the "real" strings in 
many cases, and these functions will save you a lot 
of time by doing it for you automatically 



$ . /a . exe 

Enter string to fix: this is a test 

Input string: [ this is a test ] 

After removing leading: this is a test 

After removing trailing: this is a test 

Enter string to fix: 

Input string: [] 
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Creating a 
Configuration Fife 



Save Time By 




Creating a standard inter- 


face to a configu 


'ation 


file 




Creating the 




configuration-file 




class 




V Creating the test 


input file 


V Testing the configuration- 


file class 









Configuration files are a basic part of any application that needs to 
be portable across various operating systems. Because of differ- 
ences in binary formats and "endian" concerns (placement of the 
most significant byte), configuration files are normally stored in text for- 
mat. This is somewhat problematic, as it requires the application to be 
able to load, parse, and work with the entries in a configuration file, while 
interpreting the data that is stored there. Because the format is text, you 
must worry about the user modifying the text files, changing them so 
that they are no longer in a valid format, and the like. It would make 
sense, therefore, if there were a standard interface to a configuration file, 
and a standard format for using text-based configuration files. This would 
allow you to use a standard format in all of your applications, saving you 
time and effort. 

This technique shows you how to develop a method for storing data in 
the simplest possible fashion in a configuration file (text based), while 
still allowing the users to store the kinds of data they need. A typical 
entry in one of our configuration files would look like this: 

# This is a comment 

Val ue = " Thi s is a test" 



The first line of the entry is a comment field — ignored by the parser — 
that tells any reader of the configuration file why the specific data is 
stored in this key (and how it might be interpreted or modified). The sec- 
ond line is the value itself, which is made up of two pieces: 

*>* The keyword that we are defining, in this case Value. 

The complete string assigned to this value, with embedded and possi- 
bly leading spaces. In this case, our value string is " This is a 
test". Note that when read in, the string will contain leading spaces, 
as the user wished. Note that the only reason that we store these 
spaces is that they are contained in quotation marks, indicating the 
user wished to keep them. If the spaces were simply on the leading 
and trailing edges of strings in the entry without quotation marks, we 
would remove them. 
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7 




The capability to configure applications is the 
hallmark of a professional program. If you 
build in the configuration options from the 
if t|*e Jesicw^rather than hacking on 
^itiy{pubf\tfejfr> at the end of the process), 
the result is a much more robust and extensi- 
ble application. Even if you add new options 
later on, the basis for the code will already be 
there. 



Creating the Configuration-File 
Class 

The configuration-file class encapsulates the read- 
ing, parsing, and storing of the data in the text-based 
configuration file. The following steps show you how 
to build a stand-alone class that can simply be 
moved from application to application, allowing you 
to save time and have a consistent interface. 

f m In the code editor of your choice, create a 
new file to hold the definition for your 
configuration-file class. 

In this example, the file is named 
ConfigurationFile.h, although you can use 
whatever you choose. 

2. Type the code from Listing 45-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 45-1: The Configuration File's Header File 

#ifndef _CONFIGURATIONFI LE_H_ 
#define _CONFIGURATIONFI LE_H_ 

#i include <string> 

^include <vector> 

#i include <fstream> 

#i include <map> 

#i include <list> 

using namespace std; 



class ConfigurationFile 
{ 

publ i c : 

Con fi gurati onFi 1 etconst char 
*strFi 1 eName ) ; 
vi rtual ~Confi gurati onFi 7e(void) ; 
bool read ( voi d ) ; 

bool hasValuet const char *key ); 
string getValuet const char *key ); 
void setValuet const char *key, const 
char *val ue ) ; 

protected : 

virtual void get_token_and_val ue( ] 



virtual char 




eat_ 


_whi te_and_comments ( 


bool traverse_ 


new" 


i nes=true ) ; 




vi r 


'tual bool 




adv; 


ince_to_equal_si gn_o 


n_l i ne( ) ; 


vi r 


'tual void makeLower 


(sti 




3 & i n s t r i n g ) ; 




protect 


:ed : 






fsl 


:rei 


im m_in; 




str 


'ing m_toke 


n ; 


string m_v a 1 u 


e ; 


string m_sC 


onf i g Fi 1 e ; 


typedef pair <string, 


string) 


Stri ng_ 


_Pai r ; 




map<string, string) m 

) ; 


Conf i gEntri es ; 


#endi f 









This file contains the definition of the class; it 
contains no code for manipulating the data. The 
header file acts as the interface for other applica- 
tions to use the class, as we will see. It is best to 
separate your actual implementation code from 
your definition, as this helps emphasize the 
encapsulation concept of C++. 

3. Save the source-code file. 

4, In the code editor of your choice, create a new 
file to hold the definition for the configuration- 
file class. 
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In this example, the file is named 

ConfigurationFile.cpp, although you can use 
whatever you choose. 



whatever you choose. 
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Listing 45-2 into your file. 

Listing 45-2: The Configuration File Source Code. 

#i ncl ude "Conf i gurati onFi 1 e . h" 

#i ncl ude <errno.h> 

#i ncl ude <algorithm> 

#i ncl ude <sstream> 

#i ncl ude <iostream> 

#i ncl ude <string> 

template <class T> 

bool f rom_stri ng(T &t, 

const std : : stri ng &s , 
std : : i os_base & 
(*f)(std: :ios_base&)) 

{ 

std :: i stri ngstream iss(s); 
return ! ( i ss»f»t) .fail ( ) ; 



// The following function returns a 

string with al 1 -uppercase characters, 
static string makeUpper( const strings 
i n s t r i n g ) 

{ 

string temp=i nstri ng ; 

transformt temp . begi n ( ) , temp.endO, 

temp.begint ) , ::toupper ); 
return temp; 



// The following function returns a 

string with al 1 -1 owercase characters, 
static string makeLower( const strings 
i n s t r i n g ) 



string temp; 
transformt temp. 

temp . begi n ( ) , 
return temp; 



beginO, temp.endO, 
: : tol ower ) ; 



static bool containst const strinc 
source, const char *find ) 



class StringUtil -* 
1 

publ i c : 

StringUtil () () 
-StringUtil ( ) (1 

// Find the given string in the source 

string and replace it with the 
// "replace" string, everywhere 

instances of that string exist, 
static void f i ndandrepl ace( string& 
source, const strings find, const strinc 
replace ) 

{ 

si ze_t j ; 

for (;(j = source. find( find )) 
!= string: : npos ; ) 

{ 

source. repl ace( j, 

f i nd . 1 engthO , replace ); 



return ( 0 ! =strstr ( source . 
c_str ( ) , f i nd ) ) ; 



static string pad( const strings 
instring, char padchar, int length ) 
1 

string outstring = instring; 

for ( int i = ( i nt )outstri ng . 1 ength ( ) : 
Klength; ++i ) 

outstring += padchar; 



return outstring; 



} 



Trim the given characters from the 
beginning and end of a string. 
// the default is to trim whitespace. 

If the string is empty or contains 
// only the trim characters, an empty 

string is returned, 
static string trim( const string 
& i n s t r i n g , 

const string 
Strimstri ng=stri ng ( " \t\n" ) ) 
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if ( tri mstri ng . si ze( )==0 ) return 
i n s t r i n g ; 



type begpos=i nstri ng . f i nd_f i rst_not_of (trimstring) ; 
if ( begpos==stri ng : : npos ) 
{ 

return temp; 

} 

else 
{ 

string: : si ze_type endpos = instring.fi nd_l ast_not_of (trims tri ng ) ; 
temp=i nstri ng.substrtbegpos, 
endpos-begpos+1 ) ; 
) 

return temp; 



// Convert the string to an int. Note that a string exception is thrown if 
/ / it is invalid. 

static int tolnttconst string & mylnString) 

{ 

int i=0; 

string inString = trim(mylnString) ; 

if( ! f rom_stri ng<i nt>( i , inString, std::dec) ) 
{ 

string excepti onText = "Stri ngUti 1 s : : tolnt ( ) - Not an integer: " + inString; 
throw excepti onText ; 



// Time to run some more checks. 

for (unsigned int j=0; j < i nStri ng . 1 ength ( ) ; j++) 
{ 

if ( ! i sNumeri c ( i nStri ng[ j ] ) ) 
{ 

if (j==0 && inString[j] =='-') 
{ 

conti nue ; 

} 

else 
{ 

string excepti onText = " Stri ngUti 1 s :: tolnt ( ) - Not an integer: " + 

i nStri ng ; 
throw excepti onText ; 



(continued) 
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Listing 45-2 (continued) 



return ( i ) ; 



Drop Books 

A Qtrinn pyrpntinn 



ring to an int. Note: 



A string exception is thrown if 
/ / it is invalid. 

static float toFl oat ( const string & mylnString) 

{ 

float f=0; 

string inString = trim(mylnString) ; 

if( ! f rom_st ri ng<f 1 oat>( f , inString, std::dec) ) 

{ 

string excepti onText = "St ri ngLIti 1 s : : toFl oat ( ) - Not a float: " + inString; 
throw excepti onText ; 

} 

// Now it runs some more checks, 
int dec_count=0; 

for (unsigned int j=0; j < i nSt ri ng . 1 ength ( ) ; j++) 

{ 

if ( ! i sNumeri c ( i nStri ng[ j ] ) ) 



if (j==0 && inString[j] =='-') 
( 

conti nue ; 

> 

else if ( i nStri ng[j ]=='.' ) 
< 

dec_count++; 

if (dec_count > 1) 

( 

string excepti onText = "Stri ngLIti 1 s : : toFl oat ( ) - Not a float: " + 

inString; 
throw excepti onText ; 



string excepti onText = "Stri ngLIti 1 s : : toFl oat( ) - Not a float: " + inString; 
throw excepti onText ; 



conti nue ; 



el se 



return (f ) ; 

I 
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II Returns true if the character is numeric, 
static bool isNumeric(char c) 

{ 




9' ) ; 



// Replace environment variables in the string with their values. 
// Note: environment variables must be of the form ${ENVVAR). 
static string substituteEnvVart const string &myInString ) 

{ 

string outStri ng=" " ; 
char variable[512]; 

const char *s = myInString.c_str( ) ; 

while(*s!=0) 

{ 

if (*s=='$ ' && *(s+l)==' j ' ) 

{ 

// When you've found beginning of variable, find the end. 

strcpy(variable,s+2) ; 

char *end = strchr (variable,')'); 

if (end) 

{ 

*end='\0' ; 

char *cp = (char *) getenv ( vari abl e) ; 
if (cp) 

outString += (char *) getenv ( vari abl e) ; 
s = strchr ( s ,' 1 ') ; 

else 
{ 

outString += *s; 

} 

1 

else 
{ 

outString += *s; 

} 

s++; 

} 

return outString; 

I 



(continued) 
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Listing 45-2 (continued) 



Conf i gurati onFi 1 e : : Conf i gurati onFi 1 e( const char *strConf i gFi 1 e ) 
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Conf i gurati onFi le: :~Confi gurati onFi let ) 



bool Conf i gurati onFi le: :read( ) 



m_i n . open (m_s Conf i gFi 1 e . 
c_str( ) , i os : : i n ) ; 

if (m_in.fail()) 

{ 

return false; 

I 

whi 1 e ( !m_i n . eof ( ) ) 



// Get a token and value. 

// This gives values to member vars: m_token and m_value. 

// 

get_token_and_val ue( ) ; 

if ( m_token . 1 ength ( ) ) 

m_Conf i gEntri es . i nsert( Stri ng_ 
Pai r(m_token , m_value) ); 



void Conf i gurati onFi le:: get_token_and 
val ue( voi d ) 

{ 

char token[1024] ; 
char ch ; 

bool f ound_equal =f al se ; 
int 1=0; 

eat_whi te_and_comments ( ) ; 
whi 1 e( ! (m_in.get(ch) ) .fai 1 ( ) ) 



m_i n . cl ose( 



); 



return true; 



if ((ch != ' \t' )) 
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if ( (ch == '=') || (ch == ' ') || (ch == '\n') || (ch == '\r') || 
(ch == '\t')) 

{ 



token[i++]=ch ; 




if (i==0) 

{ 

// It didn't find a token, in this case. 
m_token=" " ; 
m_val ue=" " ; 
return ; 

} 

// Nul 1 -termi nate the token that was found. 
token[i++]='\0' ; 
m_token = token; 
makeLower (m_token ) ; 

// Advance to the equal sign, if need be. 
if ( ! f ound_equal ) 

{ 

if ( ! advance_to_equal_si gn_on_l ine( ) ) 
{ 

// The token had no value. 
m_token=" " ; 
m_val ue=" " ; 
return ; 

} 



// Get the token's value. 
i=0; 

char c = eat_whi te_and_comments ( f al se) ; 

if ( c != '\n' ) 

{ 

i=0; 

while( ! (m_in.get(ch)) .fail ()) 
{ 
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ch == '=' )found_equal=true; 



if ((ch == '\f ) 



(ch == '\r' ) 



(ch == '\n' ) 



(ch == '#') ) 



whi 1 e ( ch ! = ' \n ' ) 



if (m_i n . get ( ch ) . f ai 1 ( ) ) break; 

} 



(continued) 
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Listing 45-2 (continued) 



brea k ; 
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token[i++]=ch ; 



if (i==0) 



// This token had no value. 
m_val ue=" " ; 



else 



token[i++]='\0' ; 
m_val ue=token ; 

// Remove leading/trailing spaces. 
m_value = Stri ngLIti 1 : : trim(m_val ue ) ; 

// Strip leading and trailing quotes, if there are any. 
i f ( m_val ue[0] == ' " ' ) 

m_value = m_val ue. substrt 1 ); 
if ( m_value[ m_val ue. 1 ength( ) -1 ] == '"' ) 

m_value = m_val ue. substr( 0, m_val ue . 1 ength ( ) - 1 ); 



bool 

ConfigurationFile: : advance_to_equal_si gn_on_l i ne( ) 

{ 

char ch ; 

bool found_equal =fal se ; 

while ( ! (m_in.get(ch) ) .fail ( ) ) 

{ 

if ( ( ch== ' \r ' ) | | ( ch== ' \n ' ) ) break; 
if (ch == ' = ' ) 

{ 

found_equal =true ; 
break ; 



return found_equal ; 



char 

ConfigurationFile: : eat_whi te_and_comments 
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(bool traverse_newl i nes ) 

char ch; 
ofl% 1q qommlnt : 




"conmrenT'="f I 

whi 1 e ( ! (m_in.get(ch)) .fail ()) 
if (ch == '#') 

in_comment = true; 
else if (ch == '\n') 
{ 

in_comment = false; 

if ( ! traverse_newl i nes ) 

{ 

return(ch); // Stop eating. 



else if ( ( ! i n_comment) && (ch ! = 
(ch != '\t') && (ch != '\r')) 



m_in.putback(ch) ; 
return 0; 



std::string sKey = key; 
makeLowert sKey ) ; 
if ( m_Conf i gEntri es . f i nd ( sKey. 
c_str() ) != m_Confi gEntri es . end( ) ) 
{ 

std: :map<string, string): : iterator 

iter; 
iter = 

m_Conf i gEntri es . f i nd( sKey . c_str( ) ) ; 
return (*iter) .second; 

1 

return " " ; 



void Conf i gurati onFi 1 e : : setVal ue( const char 
*key, const char *value ) 

1 

std::string sKey = key; 
makeLowert sKey ) ; 

m_Conf igEntries[sKey] = value; 



return 0; 



void Conf i gurati on Fi 1 e : : make Lower 
(string Sinstring) 

{ 

fortunsigned i=0; i < i nstri ng . si ze( ) ; 
i++) 

{ 

i nstri ng[i] = tol ower( i nstri ng[i ]) ; 



bool Conf i gurati onFi 1 e :: hasVal ue( const char 
*key ) -> 4 

{ 

bool bRet = false; 
std::string sKey = key; 
makeLowert sKey ) ; 

if ( m_Confi gEntri es . fi nd ( sKey.c_str() 
) != m_Confi gEntri es . end( ) ) 
{ 

bRet = true; 

} 

return bRet; 



Our source code above breaks down into three 
general pieces. First, we separate out all of the 
utility routines that work with strings and char- 
acters and place them in the Stri ngUti 1 utility 
class (shown at the line marked with -» 1). Next, 
we have the actual configuration-file class, 
shown at the line marked with -» 2. This class 
manages the storage and processing of the file. 
The processing is done in the read function, 
shown at -* 3, and the storage functions begin 
with the line marked -* 4. As you can see, the 
routine simply reads in a line from the input file 
and separates it into two pieces, divided by an 
equal sign. Comments, which are lines that are 
either blank or marked with a pound sign ('#') 
are ignored. Everything to the left of the equal 
sign is considered to be the "tag," while every- 
thing to the right of the equal sign is considered 
to be the "value." Tag and value pairs make up 
the configuration data. The retrieval routines 
work by allowing the user to see if a given tag is 
defined, and if so to retrieve its value. 



string Conf i gurati onFi 1 e :: getVal ue ( const 
char *key ) 



6. Save the source file in the source code editor. 
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Setting Up \lour Test File 

I A [>i ^Aftoy |>u lra^e>MJ\| cjaf*i you should create a test 
I J | V^fcr lhal ^oy (injr fi^l^s that your code is cor- 
rect, but also shows people how to use your code. 

The following steps show you how to create a test 
driver that illustrates how the class is intended to be 
used: 

f t In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch45 . cpp. 

2. Type the code from Listing 45-3 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 45-3: The Configuration-File Test Code 

#include <stdio.h> 

#i ncl ude "Conf i gurati onFi 1 e . h" 

int main( int argc, char **argv ) 

{ 

if ( argc < 3 ) 

{ 

pri ntf( "Usage : ch5_7 config-file- 
name argl [arg2 . . ]\n" ) ; 

pri ntf( "Where : config-file- 
name is the name of the configuration 
file\n") ; 

pri ntf ( " a rgl . . argn 

are the values to print out\n"); 

return -1; 

} 

ConfigurationFile cf(argv[l]); 
if ( cf . read( ) == fal se ) 

{ 

pri ntf ( "Unabl e to read configuration 
fi'le\n"); 

return -2; 



for ( int i=2; i<argc; ++i ) 

{ 

if ( ! cf . hasVal ue( argv[i] ) ) 

{ 

pri ntf ( "Val ue %s NOf found in 
configuration file\n", argv[i] ); 

} 

el se 
{ 

string s = cf.getValue 
( argv[i] ); 

printfC'Key %s = [%s]\n", 
argv[i ] , s . c_str ( ) ) ; 
) 

} 





} 


return 0; 






3. 


Save the source-code file in 


the code editor. 




4. 


In the code editor of your choice, create a new 






text file to hold the actual configuration test file 






for your test program. 








In this example, I named the test input data file 






i nput . cf g. 






5. 


Type the following text into your file: 






Col or=Bl ue 


-> 5 






Name=Matt 


-> 6 






Address=" 








Ci ty=" Denver , CO" 


7 






ZipCode=80232 








#This is a comment 





Testing the Configuration-File 
Class 

Now that everything's set up, the following steps 
show you how to put it all together and go for a test 
drive: 



Testing the Configuration-Fife Class 



Compile and run the source-code file (which 
we called ch45_7 . cpp) along with the 
[figurationjclass file (which we called 

:pp) in your favorite corn- 
operating system. 



faafiguratioibclass file 

ropfctafe 



2. Run the program. 

If you have done everything right, you should see 
the following output in your console window: 

$ ./a.exe input. cfg Color Name City State 

Key Col or = [Bl ue] 

Key Name = [Matt] 

Key City = [Denver, CO] 

Value State NOT found in configuration 

file ->8 



Looking at the input file, you can see that the values 
of Col or, Name, and Ci ty are all entries (on the left- 
hand side of the equal sign). For those keys, the val- 
ues are Bl ue, Matt, and Denver , CO. These items are 
shown at the lines marked with -* 5, -> 6 and -> 7. 
The test driver simply reads the configuration file 
using our configuration-file class and then displays 
the various key and value pairs. The test driver then 
exercises the full functionality of the retrieval code 
by looking for a value (State) that is not in the con- 
figuration file, and the code properly displays an 
error as shown by the line marked with -* 8. From 
this output, and the test driver code, you can see 
exactly how the configuration-file class was meant to 
be used, making it excellent documentation for the 
developer. You can also see from the listing that the 
output is what we were expecting, which makes it a 
good unit test. All in all, it shows just how you can 
save time and effort by using a standardized configu- 
ration format and using this class to read it. 
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Creating an 

Internationalization 

Ctass 



Once upon a time, if you were programming in the United States, 
you tailored your applications only for English-speaking 
Americans. Your main concern was the code that implemented the 
algorithms that were in your application; if you had an error message to 
display, you'd write a message that vaguely expressed the error and the 
user would just have to deal with it — no matter what language he spoke 
or how confusing the error message was. Fortunately, those days of 
usability-challenged code are over. Experts now create messages and 
indicators for applications so users can best understand what is going 
on. The error messages themselves are usually tailored to specific cus- 
tomer bases. Most importantly, however, our code is no longer directed 
only towards English-speaking Americans. Applications are distributed 
around the world, and need to work in any language, with any alphabet 
set. The capability to display messages in any language is known as 
internationalization. 

You can't simply bolt an internationalization feature onto your program — 
you have to design that capability in from the beginning. You can't just 
translate messages on the fly, either; you have to know up front what the 
message is going to say. For this reason, creating a system that supports 
internationalization is important. 

The process of internationalization is really threefold: 

f m Identify all of the text that needs to be displayed in the various lan- 
guages. Place this text into a single file, along with identifiers that can 
be used within the application to display the text. 

2. Convert the text into a format that can be shipped easily with the 
application. 



3. Provide a method to access all this content. 
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is with arw sort of i 
ifcldAg/Jthi'SaiPF 



Only by doing all this can we save time when creat- 
ing applications in multiple languages. If you write 
applica^ns with an^ sort of regional or interna- 

must internationalize 
pport up front — and giv- 
ing the application the capability to load those lit- 
eral strings from external sources — you not only 
save time later on, but also save huge amounts of 
space in your application memory. This approach 
also allows you to customize your error messages 
and display prompts directed to different age and 
regional groups. This is the procedure we will be 
using in this technique to illustrate how to save time 
and effort up front by creating a single way in which 
to internationalize your applications. 



Building the Language Files 



don't want to store all possible languages in your 
application because that would cause the memory 
requirements to go through the roof. So we store our 
languages in compressed-text format by squeezing 
out the returns and spaces between the items of 
data. These steps show you how: 

In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch46 . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for our 
automation object. 

2. Type the code from Listing 46-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Before you can display text, you need to be able 
to build files that contain the language data. You 



Listing 46-1: The StringEntry Class 



^include <stdio.h> 
^include <string> 
#include <vector> 
^include <iostream> 
^include <fstream> 

using namespace std; 

#define VERSION_STRING "Version 1.0.0" 



class StringEntry 
{ 




pri vate : 




unsigned long 


_id; 


string 


_strEntry 


unsigned long 


_of f set ; 


unsigned long 


_1 ength ; 


protected : 




void I n i t ( ) 





setID ( 0 ); 
setStri ng( " " ) ; 
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setOffsett 0 ); 



setLength( 0 ) ; 

} 




setString( aCopy . Stri ng ( ) ); 
setOffsett aCopy . Of f set ( ) ); 
setLength ( aCopy . Length ( ) ); 



} 

publ i c : 

Stri ngEntry ( voi d ) 

{ 

InitO ; 

} 

StringEntryt unsigned long id, const char *strln ) 

{ 

InitO ; 
setlDC id ); 
setStringt strln ) ; 

// For now, assign the length to just be the length 
// of the string. 
setLengtht stri en(strln) ); 

StringEntryt const StringEntry& aCopy ) 

Copyt aCopy ); 
StringEntry operator=( const StringEntry& aCopy ) 

Copy ( aCopy ) ; 



unsigned long ID() const 

return _id; 
string StringO const 

return _strEntry; 
unsigned long OffsetO const 

return _offset; 
unsigned long LengthO const 

return _length; 



(continued) 
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Listing 46-1 (continued) 



void setlDC unsigned long id ) 
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void setString( const char *strln ) 

{ 

_strEntry = strln; 

void setString( const strings sin ) 

{ 

_strEntry = sin; 

} 

void setOffset( unsigned long offset ) 

{ 

_offset = offset; 

} 

void setLength( unsigned long length ) 

{ 

_length = length; 



virtual void write( ofstream& out ) 

{ 

// Get the current output position. 

setOffsetC out.tellpO ); 

// Write out the string. 

const char *strOut = StringC ). c_str( ) ; 

out << strOut; 



virtual void dump( ostream& out ) 

{ 

out << "StringEntry: " << endl ; 



out << "ID 

out << "String 

out << "Length 

out << "Offset 



" << IDC ) << endl ; 

[" << StringC). c_str() << "]" << endl 
" << LengthC ) << endl ; 
" << OffsetO << endl ; 



class StringWriter 

{ 

private: 

vectoK StringEntry > _entries; 
string _fileName; 
string _outputFi 1 eName ; 
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string get_line( ifstream& in ) 



string sOut = 




Char = 0; 
leofU ) 



// Read in a character at a time. If we hit end of line, 

// and the last character is NOT \, we are done. 

char c; 

i n . get ( c ) ; 

if ( in. fail () ) 

break; 
if ( c — '\n' ) 
{ 

// We found a return. See whether the last thing was a backslash, 
if ( cLastChar != 'W ) 
break; 



1 

} 

sOut += c; 
cLastChar = c; 

} 

return sOut; 



virtual bool ProcessLinet const string& sin ) 
1 

// There has to be a colon (:). 
int nColonPos = s In . f i nd_f i rst_of ( ':' ); 
if ( nColonPos == string: rnpos ) 
return false; 

// Get the pieces. 

string sNumber = sln.substrtO, nColonPos); 
string sValue = sln.substrt nColonPos+1 ); 

// Add it to our list. 

StringEntry set atol ( sNumber . c_str ( ) ) , sVal ue . c_str ( ) ); 
_entri es . i nsert ( _entri es . end ( ) , se ); 

return false; 



el se 



// Remove the backslash. 

sOut = sOut . substr ( 0 , sOut . 1 ength( ) - 1 ) 



(continued) 
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Listing 46-1 (continued) 



vi rtual bool Load( ) 



DropBaoks 

if I in fail ( 



n the input file, 
f i 1 eName . c_str( ) ) ; 
if ( in. fail () ) 
return false; 



// Read in the first line for version information, 
string sLine = get_l i ne( i n ) ; 

if ( strcmpt sLine.c_str( ) , VERSION_STRING ) ) 
return false; 



for ( int i=0; i < 1 0 ; ++i ) 

{ 

if ( in. fail ( ) ) 

brea k ; 
sLine = get_l ine(in) ; 
// Ignore blank lines, 
if ( s Li ne . 1 ength ( ) == 0 ) 

conti nue ; 



// Ignore comments, 
if ( sLine[0] == '#' ) 
conti nue ; 



if ( ProcessLinet sLine ) ) 

pri ntf ( " Inval i d input: %s\n", sLine.c_str () ); 

) 

} 

publ i c : 

Stri ngWri ter( void ) 

{ 
} 

Stri ngWri ter( const char *i nputFi 1 eName , const char *outputFi 1 eName ) 

{ 

_fil eName = i nputFi 1 eName ; 
_outputFi 1 eName = outputFi 1 eName ; 
Load( ) ; 

} 

virtual bool Save( void ) -* 2 

{ 

// If there are no entries, abort, 
if ( _entri es . si ze( ) == 0 ) 
return false; 



// Try to open the output file, 
ofstream out( _output Fi 1 eName . c_str( ) ); 
if ( out. fail ( ) ) 
return false; 
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II Okay, process each of them. 
vector< StringEntry >::iterator iter; 

for ( iter = _entri es . begi n ( ) ; iter != _entri es . end( ) ; ++iter ) 




! 



// Now, process the index file. 

string i ndexFi 1 eName = _outputFi 1 eName + ".idx"; 

ofstream out2(indexFileName. c_str ( ) ) ; 

if ( out2.fail () ) 

{ 

pri ntf ( "Unabl e to open index file %s for output\n", i ndexFi 1 eName . c_str( ) ); 
return false; 

} 

for ( iter = _entri es . begi n ( ) ; iter != _entri es . end( ) ; ++iter ) 
{ 

// Write out the entry. 

out2 << (*iter) .OffsetO << ", " << (*iter) . Length( ) << ", " << (*iter).ID() << endl ; 

} 

return true; 

} 



int maind'nt argc, char **argv) 
{ 

if ( argc < 3 ) 
{ 

pri ntf ( "Usage : StringEntry input-file output-f i 1 e\n " ); 

pri ntf ( "Where : input-file is the file containing the string def i ni ti ons\n " ) ; 
printft" output-file is the final generated file name\n"); 

return ( - 1 ) ; 

} 

StringWriter s(argv[l], argv[2]); 
if ( s.SaveO == false ) 

pri ntf (" Error generating file\n"); 

return 0; 




The code above breaks down into a storage class 
(Stri ngEntry), a writing class (Stri ngWri ter), 
and a test driver that illustrates how to use the 
code. The test driver expects two arguments: a 
file that contains the string definitions and an 
argument that specifies the name of the file to 
create for an output file. The input file simply 



consists of ID numbers (integer values) followed 
by a colon and then the string to encode into the 
output file. Each entry in the definition file is 
read, parsed, and placed into a Stri ngEntry 
object. This all happens in the Load function 
of the Stri ngWri ter class shown at -> 1. After 
the entire input file is parsed, it is written to the 
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output format in the Save method of the 
Stri ngWri ter class, shown at -» 2. The result of 
runn ing this program should be a language file 
Pcjmtfljenle/Qiwd by your application for 




Save the source code in your code editor. 



Creating an Input Text File 

After we have created the application to read the 
text file and convert it into an international language 
file, the next step is to test the application by creat- 
ing a simple text file that contains strings we will use 
in the final international language file. The following 
steps show you how to do that by creating a very 
small text file we can use for testing the application: 

f m In the code editor of your choice, create a new 
file to hold the text for the test language file we 
will be using. 

In this example, the file is named test . i n . eng, 
although you can use whatever name you 
choose. This file will contain the strings we wish 
to place in the output international language file. 

2. Type the following text into your file, substitut- 
ing your own values wherever you choose. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Version 1.0.0 

# This is a comment 

# This is another comment \ 
but it is very very long 

l:Hello ->3 
2 : Goodbye 
3:Why me? 
4 : Engl i sh 
5 : French 

3. Compile the source file with your favorite com- 
piler, on your favorite operating system. 

In this example, the source file was called 
StringEntry.cpp; however, you may call it any- 
thing you like. 



4. Run the application on the operating system of 
your choice, using the input file as an argument 
to the application. 

If you have done everything correctly, you will see 
the following output in the console window, and will 
have two files created in the file system (called 

my . eng and my . eng . i dx): 

$ ./a.exe test. in. eng my. eng 

The my. eng file will look like this: 
$ cat my. eng 

Hel 1 oGoodbyeWhy me?Engl i shFrench -> 4 

The my.eng.idx file will look like this: 
$ cat my.eng.idx 

0,5 5 

5, 7 
12, 7 
19, 7 
26, 6 

As you can see from the two outputs shown above, 
after the writer is finished with the input text file, it 
is no longer truly in readable format. The strings are 
concatenated in a binary output format, with a sec- 
ondary file containing indices that indicate where 
each string starts and ends. For example, the input 
file contains the string shown in the listing at -> 3 
This string is then written to the binary output file, 
my . eng, at -* 4 The index for this particular entry 
is shown in the my . eng . i dx file at -> 5 The first 
entry in the index indicates the position in the file 
(0-based). As you can see, the string we are looking 
at begins at the first position of the output file. The 
second entry in the index indicates the length of the 
string, in this case five. So, we go to position zero, 
count off five characters and that will be our first 
string. And, as you can see, that is in fact the string 
Hello. 



Reading the International File 

After we have created the file and the index file for it, 
the next step is to build a reader that reads the strings 
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Drd 



in the various languages. The reader uses a two-step 
process to achieve this: First it reads in the index file 
so thaLiLknows where all the strings are in the file, 
iJt^Ohdg'V Itfi^to be read. The following 
tie* I^Wt*hfil/Y** this. 



Strings take up a large amount of the memory 
of an application and provide clues for hack- 
ers. For example, error messages may indicate 
where the processing for security is handled in 
the code. By finding these strings in the pro- 
gram executable file, the hacker can then 
determine where to make patches to "crack" 
your program to not require a license. When 
extracting all of the text for a system into 
external files, you should either encrypt the 
text to make it secure, or at least have it 
removed from the portion of the program that 




it describes. This will save you a lot of time in 
securing — as well as debugging — your appli- 
cation, by eliminating at least one type of 
problem from the released product. 

f m In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch46_l . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for our 
automation object. 

2. Type the code from Listing 46-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 46-2: The StringReader Class 



#include <stdic 


i.h> 




#include <vectc 


r> 




^include <strir 


g> 




#include <iostr 


eam> 




#i include <fstre 


am> 




#i include <sstre 


am> 




using namespace 


std 




class St ring I 
{ 


nc 


ex 




private: 








unsigned 


1 ong _ 


offset ; 


unsi gned 


1 ong _ 


1 ength ; 


unsi gned 


1 ong _ 


id; 


protected : 








virtual v 


oid Init( ) 



setOffset(O) ; 
setLength(O) ; 
setlD(O) ; 

) 

publ i c : 

Stringlndex(void) 
{ 

Init( ) ; 

} 

Stringlndext unsigned long offset, unsigned long length, unsigned id 



(continued) 
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Listing 46-2 (continued) 
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cotmf i H 1 • 



fset ); 
ngth ) ; 



setlDC id ); 



Stri nglndex( const Stringlndex& aCopy ) 

setOffsetC aCopy.getOffset( ) ); 
setLength( aCopy . getLength ( ) ); 
setID ( aCopy.getID( ) ); 

virtual ~Stri nglndexC ) 



Stringlndex operator=( const Stringlndex& aCopy ) 

setOffsetC aCopy . getOf f set ( ) ); 
setLength( aCopy.getLengthC ) ); 
setID ( aCopy.getID( ) ); 
return *this; 



void setOffsetC unsigned long offset ) 

_offset = offset; 
void setLengthC unsigned long length ) 

_length = length; 
void setlDC unsigned long id ) 
_id = id; 

unsigned long getOffsetC void ) const 

return _offset; 
unsigned long getLengthC void ) const 

return _length; 
unsigned long getlDC void ) const 
return id; 
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virtual void dump( void ) 

I 

cout << "Stringlndex: " << endl ; 



private: 

string _fileName; 

vector< Stringlndex > _indices; 
protected : 

virtual bool Load(void) 

{ 



string i ndexFi 1 eName = _fileName + ".idx"; 
i f stream i n ( i ndexFi 1 eName . c_str ( ) ) ; 
if ( in.failO ) 
return false; 

// Read in each line, 
while ( Mn.eofO ) 

string sin = " " ; 

while ( Mn.eofO ) 
{ 



// Get an input line, 
char c; 
i n . get ( c ) ; 
if ( in.failO ) 
break; 

if ( c !- '\r' && c !- '\n' ) 

sin += c ; 
if ( c == ' \n' ) 

break; 



if ( sln.lengthO == 0 ) 
break; 

// Okay, we have a line. Now, parse it. 
istringstream iss(sln.c_str( ) ) ; 




<< getOffsetO << endl ; 
<< getLengthO << endl ; 
<< getlDO << endl ; 



1 ; 



class StringReader 



(continued) 
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Listing 46-2 (continued) 
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char c ; 

Length = 0; 
set = 0; 
0; 

// Parse the line, eating the comma 
iss >> lOffset >> c >> ILength >> c >> 1 ID; 



Stringlndex sidOffset, ILength, 1ID); 
si .dump( ) ; 

_i ndi ces . i nsert( _i ndi ces . end ( ) , si ); 



return true; 

} 

virtual string _loadString( const Stringlndex& si ) 

{ 

i f st ream i n (_f i 1 eName . c_st r ( ) ) ; 
in.seekg( si . getOf f set ( ) ); 
string retStr; 

for ( int i=0; i <s i . get Length () ; ++i ) 
{ 

char c ; 

i n . get ( c ) ; 

if ( in. fail () ) 

brea k ; 
retStr += c; 



return retStr; 

} 

publ i c : 

StringReader(void) 

{ 
} 

Stri ngReader( const char *fileName ) 

{ 

_fil eName = fil eName; 
Load( ) ; 

I 

Stri ngReader( const Stri ngReader& aCopy ) 

{ 

_fileName = aCopy ._fi 1 eName ; 

vector< Stringlndex > : : const_i terator iter; 

for (iter = aCopy ._i ndi ces . begi n ( ) ; iter != aCopy ._i ndi ces . end ( ) ; ++iter ) 
_i ndi ces . i nsert( _i ndi ces . end ( ) , (*iter) ); 

} 

string getString( long id ) 
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// First, see if we have this id. 
vector< Stringlndex > : : const_i terator iter; 

_i ndi ces . begi n ( ) ; iter != _i ndi ces . end ( ) ; ++iter ) 
,ter) .getlDO == id ) 
rn _loadString( (*iter) ); 
return stri ng ( " " ) ; 



3. Save the source code as a file in your editor 
and close the editor application. 

Testing the String Reader 

After you create a class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 

The following steps show you how to create a test 
driver that illustrates how to read a language file, 
and shows how the class is intended to be used: 



In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch46a . cpp. 

2. Type the code from Listing 46-3 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 46-3: The StringReader Test Driver 

int maind'nt argc, char **argv) 

{ 

if ( argc < 3 ) 

{ 

pri ntf( "Usage : ch6_l string-file-name idl [id2, ..]\n"); 

pri ntf( "Where : string-file-name is the name of the compressed string file to use\n"); 
printfC idl. .etc are the ids to display\n"); 

return -1; 

} 

StringReader sReader(argv[l] ) ; 

for ( int i=2; i<argc; ++i ) 

{ 

int id = atoi (argv[i ] ) ; 

string s = sReader.getString( id ); 

printf ("String M: [%s]\n", id, s.c_str() ); 

} 

return 0; 
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3, Save the source-code file in the code editor. 

4. Compile and run the source file with your 
[ your favorite operating 
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If you have done everything right, running the appli- 
cation with the arguments shown should produce 
the following result on your console window: 

$ ./a.exe my.eng 2 3 5 9 



String 2 

String 3 

String 5 

String 9 



[Goodbye] 
[Why me?] 
[French] 
[] 




You will also see the diagnostics, which are not 
shown, for the application. If you do not wish to 
view the diagnostics, comment out the dump 
method call shown at line -* 6 in Listing 46-2. 



By looking at the output above, we can see that 
when we read data back in from the language file, 
using the indices we have defined in the program, 
we get back the same strings that we put there in the 
original language text file. This shows that the pro- 
gram is working properly and that we are getting the 
language data directly from the file — not from 
strings embedded in the application. 
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Translations 



Save Time By 

i>* Understanding hash 
tables 

f Creating a translation 
application with hash 
tables 

Creating a translation- 
text file 

Testing your application 



The hash table is one of the most valuable constructs in the 
Standard Template Library. Hash tables are data structures that 
contain two types of values, usually key-value pairs. A hash table is 
used anytime you want to either replace one value with another, or map 
a given key to a given value. (As you may imagine, it's a commonly used 
encryption tool.) 

One of the most useful things that you can do with a hash table is to 
store and look up existing values and replace them with new ones. For 
example, in a translation application, it would be nice to be able to build 
a dictionary of words and their resulting translations. The ability to 
retrieve information based on a key-value pair can save a lot of time in an 
application. For example, a search and replace feature could use this 
functionality. Alternatively, you could use this functionality to implement 
a command parser, with a mapping of strings to integer values. Using 
hash tables can save you a lot of time in translating one type of input to 
another in your applications. In this technique, we will look at that exact 
problem and how to solve it in your application code. 



Creating a Translator Class 

We will use the hash table function to create a class that "translates" text 
by replacing certain keywords in the text with other words. Imagine that 
we want to replace all occurrences of the word computer with the word 
pc, for example. This type of conversion is commonly referred to as a fil- 
ter, because it takes input and filters it to a new output format. In this 
section we will create the Translator class, which will store the text we 
wish to replace, along with the text we wish to insert in the place of the 
original. 



Technique 4 7: Hashing Out Translations 



1, In the code editor of your choice, create a new 
file to hold the code for the source file of the 
inique. 




H ft tIl t ( e^etji)fy\TQile is named ch47, although 
you can use whatever you choose. 

2. Type the following code from Listing 47-1 into 
your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 47-1: The Translator Class 

^include <stdio.h> 

#i include <string> 

#i include <map> 

#i include <fstream> 

#i include <iostream> 

using namespace std; 

class Translator 

{ 

private: 

string _fileName; 

map<stri ng , stri ng> 
protected : 

void CI ear( ) 



_di cti onary ; 



_dictionary.erase( 
_di cti onary . begi n () , _di cti onary . end( ) ); 
} 

bool Load( const char *fileName ) -» 

{ 

if stream i n ( f i 1 eName ) ; 
if ( in. fail () ) 
return false; 

// Just read in pairs of values. 

while ( ! i n . eof ( ) ) 

{ 

string word; 
string replacement; 
in >> word; 
if ( word . 1 ength ( ) ) 



return true; 

1 

publ i c : 

Translator( void ) 



Translator( const char *fileName ) 
Clear( ) ; 

setFileName( fil eName ); 
Translator( const Translators aCopy ) 

Clear( ) ; 

setFileName( aCopy . getFi 1 eNamet ) ); 

Translator operator=( const Translators 

aCopy ) 

ClearO; 

setFileName( aCopy . getFi 1 eNamet ) ); 

void setFileName( const strings 
sFil eName ) 

_fil eName = sFil eName; 
Load(_f i 1 eName . c_str( ) ) ; 

string getFileName( void ) const 

return _fileName; 

string replace( string in ) -* ■ 

ma p<string, string): : iterator iter; 

iter = _di cti onary . fi nd( in ); 

if ( iter != _di cti onary . end( ) ) 

{ 

return i ter->second ; 

} 

return in; 



in >> replacement; 
_di cti onary[word] 
ment ; 



repl ace- 
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This code simply manages the translation opera- 
tions. The code consists of three basic functions: 

anages an input file that contains 
* Id text to the new text we 
tdTeplaCeTf with. (See -> 1 .) 

This method takes a filename, attempts 
to open it, and reads in the data pairs if the 
open operation was successful. 

► The class manages the storage of the mappings 
in a hash table. (See 2.) 

This is done by the hash table, represented by 
the Standard Template Library map class. 

► The class replaces a given string with the string 
desired in the final output. (Shown at -* 3.) 

Note that we simply pass in each string and 
replace it if it is found in the hash table. If it is 
not, we return the original string. This allows 
the application to save time by not bothering 
to check if the string needs to be replaced 
or not. 

3. Save the source code as a file in your code 
editor. 

This dictionary will do all the work of loading 
data from a translation file and replacing individ- 
ual words with specified translated words. For 
example, consider the idea of replacing all occur- 
rences of the word good with the word bad. If we 
were given the input string good day, I am having 
a good time at this goodly party, we would trans- 
late this into bad day, I am having a bad time at 
this goodly party. Note that we only replace full 
matches, not text that appears anywhere in the 
input string. The class now exists, the only thing 
we need to do is use it. 



Testing the Translator Class 

After you create the dictionary, you should create a 
test driver that not only ensures that your code is 
correct, but also shows people how to use your code. 



The following steps show you how to create a test 
driver that illustrates various kinds of input from the 
user, and shows how the class is intended to be used: 

f. In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch47 . cpp. 

2, Append the code from Listing 47-2 into your file. 

Better yet, copy the code from the source file on 



this book's companion Web 


site. 




Listing 47-2: The Translator Class Test Driver 




int ma" 


int ) 






{ 

Tr; 
pr" 


inslator t(" 'trans! at. 
i ntf( "Enter some tex 
') : 


e.txt" ) ; 
t to trans" 


-+ 4 

ate : 


Stl 


- i n g in; 






boi 


)1 bDone = false; 






wh" 

{ 


ile ( IbDone ) 




-> 5 




char c; 
ci n . get ( c ) ; 
if ( c == ' \n' ) 
bDone = true; 

el se 







i n += 



printf( "Initial 
i n . c_str( ) ) ; 



string: %s\n", 



// Break it down into words, 
string word; 

for ( int i=0; i <i n . 1 ength ( ) ; ++i ) 
{ 

if ( in[i] == ' ' ) 

{ 

if ( word . 1 ength ( ) ) -* 
{ 

string sOut = t.replace( 

word ) ; 
cout << sOut << " "; 

} 

(continued) 
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Listing 47-2 (continued) 



word 
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n[i]; 



if ( word . 1 ength ( ) ) 

{ 

string sOut = t.replace( word ); 
cout << sOut << " " ; 



The code above simply reads input from the 
keyboard, breaks it down into words, and then 
calls the translator to replace any portions of 
the string that need to be translated from our 
input file. The translator operates on a file called 
translate.txt, as shown at -* 4. You can easily 
change this filename, or even pass one in on the 
command line, if you wish. Each line is read from 
the keyboard, one character at a time, until a car- 
riage return is encountered. (See -* 5.) Finally, we 
parse the input line until we encounter a space 
(shown at -> 6) or the end of the string (shown 
at -* 7). When this happens, we replace the 
"word" we have parsed by calling the replace 
method of the translator. 

3. Save the source-code file in the editor and then 
close the editor application. 



4. Compile the source file, using your favorite 
compiler on your favorite operating system. 

5. In your code editor, create a translation-text 
file. 

This file will contain the pairs of words to be 
used in the translation file; each pair consists of 
a word and the translated version of that word. I 
called mine translation, txt, but you can call it 
whatever you like. 

6. Put the following text into thetranslation.txt 
file: 

good bad 
insult d i s 
talk jive 

You can place any words you want in the file. The 
first word will be replaced by the second word in 
any sentence you input into the system. 

7. Run the program on your favorite operating 
system. 

If you have done everything properly, you should 
see output resembling this: 

. /a . exe 

Enter some text to translate: 
Initial string: you are so good to 

tal k and not insult me 
you are so bad to jive and not dis 
me 
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V Understanding virtual 
files 

Creating a virtual file 
class 

f Testing your class 



These days, application data can be very large and can consume a 
lot of your memory. Depending on your application footprint and 
target operating system, loading the entire application file into 
memory at one time may be impossible. Memory shortages are common 
with embedded systems, and with hand-held devices, where only a lim- 
ited amount of memory is available to share between numerous applica- 
tions. There are a number of ways to handle such conditions, from 
reading in only as much data as you can and not storing the remainder, 
to limiting the data to chunks and forcing the user to select which chunk 
they want. None of these solutions, however, is quite as elegant to either 
the developer or the end-user as the virtual file. A virtual file is a window 
into the file you are trying to process. It appears to end-users as if they're 
seeing the whole file at once — but they're really seeing just one small 
piece of it at a time. If you build virtual views of your files into your appli- 
cation up front, you save time in the long run, because you won't have to 
go back and redesign your applications when the files become larger 
than you were expecting. 



The capability to provide a virtual window into a file not only conserves 
memory, it also conserves speed. By loading only a small chunk of 
the file at any given moment, you can load immense files in no time 
and all, and page through them very quickly. This method is used by 
many large text editors. 




Creating a Virtual File Class 

In order to manage virtual files, we will need two different classes. First, 
we will need a single class that manages a given chunk of data from the 
file. This class will manage the data in that chunk, as well as keep track of 
where that particular piece of data was read from the file and how big it 
is. After this, we need to have a manager that keeps track of all of those 
chunks of data, allocating new objects to manage the individual pieces 
that are read in, and deleting the pieces that are no longer used. Let's cre- 
ate a few classes to do that now. 
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f m In the code editor of your choice, create a new 
file to hold the code for the source file of the 
inique. 




H ft t3 te^etpjfy\TQile is named ch48.cpp, 
although you can use whatever you choose. This 
file will contain the class definition for our virtual 
file manager objects. 



2. Type the code given in Listing 48-1 into your 
file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 48-1: The Virtual File Manager Classes 



#i ncl ude 
#i ncl ude 
#i ncl ude 
#i ncl ude 



<i ostream> 
<stri ng> 
<vector> 
<f stream> 



using namespace std; 
class FileChunk 



private: 
string 
1 ong 
1 ong 
bool 
1 ong 

protected : 



_chunk ; 
.offset ; 
J ength ; 
_i nuse ; 
.accesses ; 



void ClearO 



-1 ; 
-1; 



_of f set 
_1 ength 
_c h u n k = " " ; 
_i nuse = fal se ; 
_accesses = 0; 

} 

void Copy( const FileChunk& aCopy ) 

{ 

_offset = aCopy ._of f set ; 
_length = aCopy ._1 ength ; 
_chunk = aCopy ._chunk ; 
_inuse = aCopy ._i nuse ; 

} 

bool Read ( ifstreamS in, long pos, long length ) 

{ 

_offset = pos; 
_chunk = "" ; 
_length = 0; 

// Seek to the position in the stream, 
i n . seekgt pos ) ; 
if ( in. fail () ) 
return false; 
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II Read up to the end of the file or the last of the length 
// bytes. 

for ( int i=0; Klength; ++i ) 



break; 
_length ++; 
_chunk += c; 

} 

_inuse = true; 



FileChunkt void ) 
ClearO ; 

FileChunk( ifstream& in, long pos, long length ) 
Clear( ) ; 

Read( i n , pos , 1 ength ) ; 

FileChunkt const FileChunk& aCopy ) 

ClearO; 
Copyt aCopy ); 

FileChunk operator=( const FileChunk& aCopy ) 

ClearO ; 
Copyt aCopy ); 
return *this; 

// Accessors 
long OffsetO 

return _offset; 
long Lengtht) 

return _length; 

stri ng& Chunkt ) 

_accesses ++; 
return _chunk; 

bool InUse(void) 

return _inuse; 




if ( in. fail () ) 



publ 



C : 



(continued) 
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Listing 48-1 (continued) 
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id setOfffetC long offset ) 
f set ; 

void setLength( long length ) 



_length = length; 
void setChunk( const strings chunk ) 
_chunk = chunk; 
ong AccessCount( void ) 
return _accesses ; 
bool Load( ifstream& in, long offset, long length ) 
Clear( ) ; 

return Read( in, offset, length ); 



const int kChunkSize = 128; 

class Fi 1 eChunkManager 

{ 

pri vate : 

int _numChunks; 

FileChunk *_chunks; 

if st ream _i n ; 

string _fileName; 
protected : 

FileChunk *findChunk( long theOffset ) 

{ 

for ( int i=0; i <_numChunks ; ++i ) 

{ 

if ( _chunks [i ] . InUse( ) == true ) 

( 

long offset = _chunks[i ] .OffsetC ) ; 
long length = _chunks[i ] . Lengtht ) ; 

if ( theOffset >= offset && theOffset <= of f set+1 ength ) 
return &_chunks[i ] ; 



return NULL; 

} 

FileChunk *addChunk( long theOffset ) 
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I 

for ( int i=0; i <_numChunks ; ++i ) 
{ 

unks[i ] . InUse( ) == false ) 

_chunks[i ] . Load( _in, theOffset, kChunkSize ) ) 
return &_chunks[i]; 

) 

} 

return NULL; 

} 

Fi 1 eChunk *getLeastRecentlyAccessed( ) 

{ 

int idx = 0; 

long access = _chunks [0] . AccessCount ( ) ; 

for ( int i=0; i <_numChunks ; ++i ) 

{ 

if ( _chunks[i ] . InUset ) == true ) 
{ 

if ( _chunks[i ] .AccessCountt ) < access ) 
{ 

i dx = i ; 

access = _chunks[i ] .AccessCountt ) ; 

} 

} 

) 

return &_chunks[idx] ; 

} 

public: 

FileChunkManager(void) 

{ 

_numChunks = 0; 
_chunks = NULL; 

} 

Fi 1 eChunkManager ( const char *fileName, int nMaxChunks ) 

I 

_numChunks = nMaxChunks; 

_chunks = new FileChunkL" nMaxChunks ]; 

_fileName = fileName; 

_i n . open ( f i 1 eName ) ; 

} 

Fi 1 eChunkManagert const Fi 1 eChunkManager& aCopy ) 

{ 

_numChunks = aCopy ._numChunks ; 
_chunks = new FileChunkL" _numChunks ]; 
for ( int i=0; i <_numChunks ; ++i ) 
_chunks[i] = aCopy ._chunks [i ] ; 
_fileName = aCopy ._fi 1 eName ; 
_in.open( _f i 1 eName . c_str ( ) ); 

} 

(continued) 
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Listing 48-1 (continued) 

virtual ~Fi 1 eChunkManager( void ) 

DropBooks 1 

char operator[]( long offset ) 

{ 

// Find which chunk this offset is in. 
FileChunk *chunk = findChunk( offset ); 
if ( chunk == NULL ) 

{ 

// There are none. See whether we can add one. 
chunk = addChunk( offset ); 

} 

// If we have one, just get the data from it. 
// Otherwise, we have to go dump one. 
if ( ! chunk ) 

{ 

chunk = getLeastRecentlyAccessedt ) ; 
chunk->Load( _in, offset, kChunkSize ); 

} 

// Finally, extract the piece we need, 
int pos = offset - chunk->Offset( ) ; 
return chunk->Chunk( )[pos] ; 



// Dump the function to illustrate what is in the chunks, 
void Dump(void) 

( jdL 
for ( int i=0; i <_numChunks ; ++i ) 

{ 

pri ntf( "Chunk M: %s\n", i, _chunks[i ] . InUse( ) ? "In Use" : "NOT Used" ); 
printfC'Offset: %ld\n", _chunks[i ] .OffsetC ) ); 
pri ntf( " Length : %ld\n", _chunks[i ] . Length( ) ); 
if ( _chunks[i ] . InUse( ) ) 

pri ntf ( "St ri ng : [%s]\n", _chunks[i ] .Chunk( ) .c_str( ) ); 




The code above shows the two basic classes: the 
Fi 1 eChunk and Fi 1 eChunkManager classes. The 
Fi 1 eChunk class, shown at -* 1, manages a single 
chunk of data in the file. This data includes the 
offset within the file, the file object itself, and the 
text from that location in the file. It also stores 
the length of the chunk that was actually read in, 
since some chunks at the end of the file could be 
smaller than the full size block. The second class, 



the Fi 1 eChunkManager class, shown at -» 2, main- 
tains an array of Fi 1 eChunk objects, keeping track 
of which ones are in use and what their offsets are. 
When a block of the file is requested, the man- 
ager object looks through its list to see if there is 
a block that has that data in it and if so, requests 
that particular text from that particular object. 

3, Save the source file in the code editor. 
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Testing the Virtual file Class 
L/ 1 Uif^[EMi£\iflM\*S>es 



iou should create a test 
as that your code is cor- 
rect, but also shows people how to use your code. 



The following steps show you how to create a test 
driver that illustrates various kinds of input from the 
user, and shows how the class is intended to be used: 

f. In the code editor of your choice, reopen 
the source file to hold the code for your test 



program. 




In this exampl 


e, I named the test program ch48. 


2. Type the code 
file. 


shown in Listing 48-2 into your 


Better yet, copy the code from the source file on 
this book's companion Web site. 


Listing 48-2: The Virtual File Class Test Driver 


int maintint ar 


gc, char **argv) 


{ 

if ( a r g c < 


2 ) 


{ 

pri ntf ( 
pri ntf ( 
to 1 c 

} 


"Usage: ch6_3 f i 1 ename\n" ) ; 
"Where: filename is the file 
a d \ n " ) ; 


Fi 1 eChunkManager f 7 cm ( argv[l], 5 ); 
for ( int i=0; i<4096; ++i ) 


i 

char c 

} 


= fcm[i]; 


fern. Dump( ) ; 




return 0; 

} 





3, Save the source-code file in your code editor 
and close the editor application. 



4. Compile the entire application with your 
favorite compiler on your favorite operating 
system. 

5. Run the application. 

You will need to pass in a filename for the program 
to manage. For this example output, I used the 
actual text file representing the program, ch48 . cpp. 

If you have done everything properly, you should 
see the output shown in Listing 48-3 when you run 
the application on a given program. 



Listing 48-3: Output from the Test Driver 

Chunk 0: In Use 

Offset: 3999 

Length: 128 

String: [ 

int pos = offset - chunk->Offset( ) : 
return chunk->Chunk( ) [pos] ; 



// Dump function to illustrate what is 
in the chunks. 

] 

Chunk 1: In Use -> 
Offset: 129 
Length: 128 
String: [ate: 

string _chunk; 

long _offset; 

long _length; 

bool _inuse; 

long _accesses; 
protected : 

void Cleart) 

{ 

_offset = -1;] 
Chunk 2: In Use 
Offset: 258 
Length: 128 
String: [et = -1; 

_length = -1; 

_c h u n k = " " ; 

_inuse = false; 

_accesses = 0; 

} 

void Copy( const FileChunk& aCopy ) 

(continued) 
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Listing 48-3 (continued) 



offseti ] 




'Length: 128 
String: [offset 
_1 ength 
_chunk = 
in use = 



= aCopy ._of f set ; 
= aCopy ._1 ength ; 

aCopy._chunk; 

aCopy ._i nuse ; 



bool Read( ifstream& in] 
Chunk 4: In Use 



Offset: 


516 




Length : 


128 




Stri ng : 
{ 


[& in, 


ong pos, long length ) 




_of f set 


= pos ; 




_chunk = 






_1 ength 


= 0; 




// Seek 


to the position in the 



stream 



in.se] 



The output above indicates how each chunk of the 
file is read in and in what order. You can see how the 
individual chunks were read in, such as the one 
shown at the line marked with -* 3. You can see that 
the chunk consists of a block of text 128 bytes long, 
starting at position 129. This chunk is marked "In 
Use," indicating that the manager is still processing 
from that chunk. 



the chunk consists of a block of text 128 bytes long, 
starting at position 129. This chunk is marked "In 
Use," indicating that the manager is still processing 
from that chunk. 

As you can see from the above output, the file is 
read in chunks, and those chunks are not specifically 
in position order. There are never more than 512 
bytes in use at any given time, but it appears to the 
user as if the entire file is available for use. 

Improving \lour Virtuat 
File Class 

While the virtual file class is certainly useful as it 
stands, there are a number of improvements that 
could be made to it, such as these: 

*>* The size of each chunk could be made 
configurable. 

The simple algorithm that determines which 
chunk to throw away when all available chunks 
have been used could be enhanced. 



Several chunks of the file's data could be pre- 
loaded at startup to minimize the startup time 
for reading pieces. 

Always keep a list of possible improvements 
along with your classes as you write them. 
When you come back to the class — or some- 
one else takes it over — it will have a built-in 
to-do list that enhances it and raises its value. 
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Using Iterators for 
j/our Collections 



Collections are at the heart of the Standard Template Library (STL). 
They form the basis for the reusability of all reuse in your classes — 
and allow you to treat large groups of data in both ordered and 
unordered fashions. Without collections, coding would be a lot more of a 
problem — we'd have to write up our own arrays, linked lists, and the 
like. You can certainly still write your own array classes or even use 
static arrays, but these classes would not have the years of testing and 
usage collections have, which means more bugs, more design problems, 
and an overall slower development process. By using the classes in the 
STL for containers, you save time by not having to develop your own 
classes, and by not having to debug code you have just written to imple- 
ment your own container. 

To interface with collections of any sort, the STL offers a generic tool 
called the iterator. Iterators are very useful, very simple tools that allow 
you to get at any piece of a collection, manipulate it, and print out the 
values of the container's data elements. Pretty handy, but iterators are 
capable of much more than this — as demonstrated in this technique. 
An iterator, as its name implies, allows you to "iterate over" (or move 
through) a collection of data. For example, when writing standard C++ 
arrays, we might produce some code that looks like this: 

i nt a rray [20] ; 

for ( int i=0; i < 2 0 ; ++i ) 

pri ntf( "Array element %d = M\n", i, array[i] ); 

This code works for a normal array, because all of the elements in the 
array are guaranteed to be contiguous in member. With the STL contain- 
ers, that guarantee does not exist. The STL containers manage buckets of 
data, which may be scattered around in memory. With an iterator class, 
however, we can treat our STL collections just as if they were like the 
code above. 



Save Time By 

i>* Using collections 

Understanding iterators 

Manipulating collections 
with iterators 

Interpreting your output 



/^W\ If you are using collections in your applications, make sure you define 
L. I -gj an iterator that has access to those collections. That iterator will give 

you a standardized way of working with the data without requiring 

you to do a lot of extra work. 
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In this technique I show you an example of using 
container collections in the STL and how to use iter- 
ators wjlli those collections. I explore several differ- 
fWk!r3|ilrfs^3m vectors (arrays) to 
ifciilcNiltlXltttfl cases, we can iterate 
over these collections using the same kinds of itera- 
tors. I explain how to move forward and backward 
through the collections, as well as how to insert and 
remove things from the various container types. 
Finally, I examine some of the cooler things about 
iterators, such as swapping elements and using iter- 
ators on files. The following steps get you started: 



f m In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch49 . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for the 
needed automation object. 

2. Type the code from Listing 49-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 49-1: Iterating over the Collection Classes in the STL 



//include <iostream> 

//include <string> 

//include <vector> 

//include <map> 

//include <list> 

//include <fstream> 

//include <algorithm> 

//include <iterator> 

//include <set> 

using namespace std; 

int main( int argc, char **argv ) 

i 

// Add a bunch of items to each type, 
char *names[] = { 

"Matt" , 

"Sarah" , 

"Rachel " , 

"Jenny" , 

" Lee" , 

"Kim" , 

NULL 



// First, do the vector. 
vector< string > nameArray; 
for ( int i=0; names[i]; ++i ) 

( 

nameArray . i nsert( nameArray . end () , names[i] ): 
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// Next, load the map. 

map< char, string > nameMap; 

for ( int i=0; names [i]; ++i ) 

es[i][0] ] = names[i]; 



st is next. 
list< string > nameList; 
for ( int i=0; names C i ] : ++i ) 

{ 

nameLi st . i nsert ( nameLi st . end ( ) , names[i] ); 



// Sets are popular. 

set<string, greater<stri ng> > nameSet; 

for ( int i=0; names[i]; ++i ) 

{ 

// fry inserting them twice to see what happens. 
nameSet . i nsert ( nameSet . end ( ) , names[i] ); 
nameSet . i nsert ( nameSet . end () , names[i] ); 

} 

// Now, iterate over them. 

for ( int i=0: i <nameArray . si ze( ) ; ++i ) 

pri ntf ( "Array [%d] = %s\n", i, nameArray [i ] . c_str ( ) ); 

map<char, stri ng> : : i terator iter; 
int idx = 0; 

for ( iter = nameMap . begi n () ; iter != nameMap . end () ; ++iter ) -> 1 

{ 

printfC'Map Entry [%d] : \n" , idx); 

printfC'Key : %c\n", (*i ter ) . f i rst ); 

pri ntf ( "Val ue : %s\n", (*iter) .second. c_str( ) ); 

idx ++; 

} 



pri ntf ( "Set : \n" ) ; 

set<string, greater<stri ng> >::iterator set_iter; 

for ( set_iter = nameSet . begi n () ; set_iter != nameSet . end () ; ++set_iter ) 

{ 

printfC'Set Entry: %s\n", (*set_iter) .c_str( ) ); 

} 



pri ntf ( "Ori gi nal Li st : \n" ) ; 
list<string>: : iterator 1 i st_i te r ; 

for ( list_iter = nameList. begint ) ; list_iter != nameLi st . end () ; ++list_iter ) 

{ 

printfC'List Entry: %s\n", (*1 ist_iter) .c_str( ) ); 

} 

(continued) 
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Listing 49-1 (continued) 



II Iterators can be used to remove items. 




( list.iter = nameLi st . begi n ( ) ; list_iter != nameLi st . end ( ) ; ++list_iter ) 



// Note, once we delete something, the iterator is no longer 
// valid. 

nameLi st . eraset list_iter ); 
brea k ; 



pri ntf ( " Fi nal List:\n"); 

for ( 1 i st_i ter = nameLi st . begi n () ; 1 i st_i ter != nameLi st . end () ; ++list_iter ) 

{ 

printfC'List Entry: %s\n", (*1 i st_i ter ) . c_st r ( ) ); 

} 

// You can also iterate in reverse. -* 2 

printfC'In reverse\n"); 
list<string>:: rever se_i terator riter; 

for ( riter = nameLi st . rbegi n () ; riter != nameLi st . rend () ; ++riter ) 

{ 

printfC'List Entry: %s\n", (*riter) .c_str( ) ); 

li * 

// Iterators can be used to swap two elements. 
iter_swap ( nameLi st . begi n () , - -nameLi st . end( )) ; 
pri ntf ( "Swapped : \n" ) ; 

for ( list_iter = nameLi st . begi n () ; list_iter != nameLi st . end () ; ++list_iter ) 

{ 

printfC'List Entry: %s\n", (*1 ist_iter) .c_str( ) ); 

I 



// Finally, you can iterate over streams, 
ifstream i n ( "ch6_4 . cpp" ) ; 

i stream_i teratoKstri ng> cinPos(in); -* 3 

for ( int i=0; i<10; ++i ) 

{ 

if (cinPos != i st ream_i terator<st ri ng> ( ) ) 

( 

cout << *cinPos++; 

} 

cout << endl ; 



cout << endl ; 



return 0; 

I 
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The code above shows the various ways in which 
we can iterate over the collection classes in the 
XL. For example, at -> 1, you see the iteration 
jrwa*«citec*i*n. Maps are normally 
SsfiMjj/rp\p^t> to given elements in them, 
but, as you can see here, they can also be listed 
in order using iterators. Line -> 2 shows how we 
can iterate over a collection in reverse — that is, 
by starting at the end and working our way back 
to the beginning — simply by changing the type 
of iterator we use. Note that even though we are 
going backwards through the container objects, 
we still increment the iterator. This means that 
we could write a single block of code to iterate 
over a collection and then select the iterator we 
wish to use for direction without having to 
change any of the code. 

3. Save the source-code file in your editor and 
close the editor application. 

4. Compile the application, using your favorite 
compiler on your favorite operating system. 

5. Run the program on your favorite operating 
system. 

If you have done everything properly, you should 
see the output shown in Listing 49-2 in your console 
window. 



Listing 49-2: Output from the Iterator Test 



Array [0] 


= Matt 


Array[l] 


= Sarah 


Array [2] 


= Rachel 


Array [3] 


= Jenny 


Array [4] 


= Lee 




Array [5] 


= Kim 




Map Entry 


[0]: 




Key 




J 


Val ue 




Jenny 


Map Entry 


[1]: 




Key 




K 


Val ue 




Kim 


Map Entry 


[2]: 




Key 




L 


Val ue 




Lee 


Map Entry 


[3]: 





Key 
Val ue 

Map Entry[4]: 

Key 

Val ue 

Map Entry[5]: 

Key 

Val ue 

Set: 



: M 

: Matt 

: R 

: Rachel 

: S 

: Sarah 



Set 
Set 
Set 
Set 
Set 
Set 
0 r i g i 
List 
List 
List 
List 
List 
List 
Final 
List 
List 
List 
List 
List 
In re 
List 
List 
List 
List 
List 
Swapp 
List 
List 
List 
List 
List 
#incl 
<i ost 
#incl 
< s t r i 
#i ncl 
<vect 
#i nc 
<map> 
#i nc 
<1 i st 



ntry : 
ntry : 
ntry : 
ntry : 
ntry : 
ntry: 
n a 1 Li 
Entry 
Entry 
Entry 
Entry 
Entry 
Entry 
List 
Entry 
Entry 
Entry 
Entry 
Entry 
verse 
Entry : 
Entry : 
Entry : 
Entry : 
Entry : 
ed: 

Entry : 
Entry : 
Entry : 
Entry : 
Entry : 
ude 
ream> 
ude 
ng> 
ude 
or> 
ude 

ude 

> 



Sarah 

Rachel 

Matt 

Lee 

Kim 

Jenny 

st: 
Matt 
Sarah 
Rachel 
Jenny 
Lee 
Kim 

Sarah 

Rachel 

Jenny 

Lee 

Kim 

Kim 

Lee 

Jenny 

Rachel 

Sarah 

Kim 

Rachel 

Jenny 

Lee 

Sarah 
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The output shown in Listing 49-2 shows that our 
test program is running properly. We can see, 

k that the ejitry Matt was removed from 
lee from -> 5 that the 
le list were swapped. 
This indicates that our code works properly. 



from -s^Lthat the entry Mat 

rapfioote 



As you can see, the iterator is an extremely powerful 
tool. Not only can it be used on all sorts of various 
collections, but it also allows you to treat a stream 
as simply a collection of data (shown in Listing 49-1 
at -* 3). (Of course, when you think about it, that's 
exactly what a stream is.) The stream is passed to 
the stream iterator, which then allows us to step 
through the file one character at a time jumping to 
whatever position they wish in the file by increment- 
ing or decrementing the iterator. 



Be careful with iterators 

Here are a couple of important caveats when you're using 
iterators: 

}/* If you remove items from the collection using an itera- 
tor, you cannot assume that the iterator you used 
remains usable afterwards. Iterators maintain internal 
state, so they are "pointing at" an invalid item in the 
container. After you have removed items, close the 
iterator and reset an iterator for the collection again. 

v* Iterators come in two forms, const and non-const. 
Use const iterators for constant collections, to ensure 
that no data is modified. 
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Save Time By 

V Exploring memory 
allocators 

V Using memory allocators 

<>* Implementing a memory 
allocator with an existing 
framework of classes 

Interpreting output 



One of the real strengths of the Standard Template Library (STL) is 
that you can configure classes to fit your specific needs. For exam- 
ple, you can put any class you need in a given template, so long as 
the class follows certain basic rules. Or you can change the way in which 
memory is allocated for the collection — you could allocate memory 
from a static heap for a given collection, for example, or perhaps make 
the memory persistent through the allocation mechanism (that is, not 
allow memory to be moved around on the system). These two examples, 
specifically, would allow you to utilize the STL in an embedded system. 
Whatever you can dream up for your system to use, the STL can handle. 

The purpose of memory allocators is to provide the container classes with 
a class-independent way of getting memory to use for storage of objects. 
For example, when I define an array in standard C++, such as this: 

i nt a rray [20] ; 

I request 20 words of storage from the compiler. Likewise, I can dynami- 
cally allocate a block of memory, like this: 

int *array = new int[20]; 

In this case, I have dynamically requested the same 20 words of storage, 
but this time from the operating system itself, rather than from the com- 
piler. Within the STL, however, the problem is more complicated. How do 
we allocate blocks of memory when we don't know exactly how big those 
blocks will be? This is what allocators do for us; they allow us to allocate 
blocks of memory within the STL containers. 

The capability to replace the way memory is allocated can be very 
important if you are working in a memory-constrained environment, or 
one in which memory is allocated in a special way. This capability spares 
you from having to change the underlying code to make your classes 
work. By implementing custom allocators in your applications, you can 
trace allocations, look for errors in your code, and switch things out 
speedily should the occasion arise. This technique takes a look at the 
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basics of implementing your own allocator for the 
STL — and using it with the existing framework of 
classes^ecause we.can change the allocator for the 
Tyjffl| Js^ \^can configure them to 
'f&umVenThViliSlents, such as embedded 
systems, different operating systems, or even hand- 
held devices that allocate memory in a completely 
different way. By understanding how to change the 
allocation of memory you will save time in debug- 
ging complicated memory, errors, or in porting your 
code from system to system. 



Creating a Custom 
Memory Allocator 



In order to explore the way in which memory is allo- 
cated in the STL, let's create a simple skeleton that 



will allow us to override the default memory allocator 
for a container class. This will show you how the 
allocation process works, and allow you to have a 
template from which you can create your own allo- 
cators, should the need arise. Understanding this 
process will save you enormous time in figuring out 
memory allocators, which are not particularly well 
documented in the STL documentation. 

In the code editor of your choice, create a new 
file to hold the code for the header file of the 
technique. 

In this example, the file is named ch50 . h, although 
you can use whatever you choose. This file will 
contain the class definition for your allocator. 

2, Type the code from Listing 50-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 50-1: The Allocator Class Definition File 



#ifndef _ALL0CAT0R_H_ 
#define _ALL0CAT0R_H_ 

#include <limits> 
^include <iostream> 

using namespace std; 

template <class T> 
class MyAlloc j 
publ i c : 

// Type the definitions. 

typedef T value_type; 

typedef T* pointer; 

typedef const T* const_poi nter ; 

typedef T& reference; 

typedef const T& const_ref erence ; 

typedef std::size_t size_type; 

typedef std : : ptrdi f f_t di f f erence_type ; 



template <class U> 
struct rebind { 

typedef MyAlloc<U> other; 

}; 



Creating a Custom Memory Allocator 



II Return the address of values. 
T* address (T& value) const { 
return &value; 
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and destructor 

* have nothing to do because the allocator has no state. 
*/ 

MyAllocO throwO 



MyAl 1 oc ( const MyAlloc&) throwO 



template <class U> 

MyAlloc (const MyAlloc<U>&) throwO 



MyAllocO throwO { 



/ Return maximum number of elements that can be allocated. 
size_t max_size () const throwO 

return numeric_l imits<std: :size_t>: :max( ) / sizeof(T); 



/ Allocate but don't initialize num elements of type T. 
* allocate (size_t num, const void* = 0) 

// Print message and allocate memory with global new. 
cerr << "allocate " << num << " element(s)" 

<< " of size " << sizeof(T) << std::endl; 
T* ret = (T*) (:: operator new(num*si zeof (T) ) ) ; 
cerr << " allocated at: " << (void*)ret << std::endl; 
return ret; 

} 

// Initialize elements of allocated storage p with value value, 
void construct (T* p, const T& value) 

{ 

// Initialize memory with placement new. 
new((void*)p)T(value); 



// Destroy elements of initialized storage p. 
void destroy (T* p) 



// Destroy objects by calling their destructor. 
p->~TO; 



(continued) 
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Listing 50-1 (continued) 



II Deallocate storage p of deleted elements, 
id deallocate (T* p, size_t num) 



l_ ^ r""\ deallocate ( 

DropBooRs 
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age and deallocate memory with global delete, 
cerr << "deallocate " << num << " element(s)" 
<< " of size " << sizeof(f) 
<< " at: " << (void*)p << std::endl; 
operator del ete( ( voi d*)p ) ; 



// Return that all specializations of this allocator are interchangeable. 

template <class Tl, class T2> 

bool operator== (const MyAl 1 oc<f 1>& , 

const MyAl 1 oc<f2>&) throwO { 

return true; 

) 

template <class Tl, class T2> 

bool operator!- (const MyAl 1 oc<Tl>& , 

const MyAl 1 oc<T2>&) throwO 

{ 

return false; 

} 



#endi f 



The listing above does not actually do anything; 
it simply implements the class definition for our 
allocator. We have overriden four methods that 
really matter here: 

► al 1 ocate, shown at -* 1. This method is 
called to specifically allocate a block of mem- 
ory. In our case, we simply return a block 

of memory while printing some diagnostic 
information. 

► construct, shown at -* 2. This method is 
called to create a new object given a block of 
memory. Fortunately, C++ allows for a special- 
ized version of the new operator, called the in- 
place new that allows you to construct an 
object within a pre-allocated block. This 
allows us to use the block allocated by the 

al 1 ocate method. 

► destroy, shown at -* 3. This method is not 
intended to de-allocate the block of memory, 



because it could be reused in the container 
later on. Instead, it simply invokes the 
destructor directly for the class. 

► deal 1 ocate, shown at -* 4. This method frees 
up the allocated block that was allocated in 
the al 1 ocate method. Once again, we added 
some diagnostics here. 

3, Save and close the source file in the editor. 

4, In the code editor, create a new file to hold the 
code for the source file of the technique. 

In this example, the file is named ch50 . cpp, 
although you can use whatever you choose. 
This file will contain the test code for using the 
allocator. 

5, Type the code from Listing 50-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Creating a Custom Memory Allocator 



Listing 50-2: The Test Driver for the Custom Allocator 

#include <vector> 



#i»stade "Al 1 ojator . h" 

DropBoQks 



private: 

char *_buffer; 
int _length; 

virtual void InitU 



setBuffert NULL ); 
setLengtht 0 ) ; 

virtual void Messaget const char *msg ) 

cout << "MyBuffer: " << msg << endl ; 



publ 



MyBuffert void ) 

Messaget "Void Constructor"); 
InitO ; 

MyBuffert int length, const char 
*inBuffer ) 

Messaget " Ful 1 Constructor"); 
setLengtht length ) ; 
setBuffert inBuffer ); 

MyBuffert const MyBuffer& aCopy ) 

Messaget "Copy Constructor"); 
setLength ( aCopy .getLengtht ) 
setBuffert aCopy . getBuf fert ) ] 

virtual -MyBuffert void ) 

Messaget "Destructor") ; 
if ( .buffer ) 

delete [] _buffer; 



MyBuffer operator=( const MyBuffer& 
aCopy ) 

Messaget "operator-") ; 
setLength ( aCopy . getLength ( ) ); 



setBuffert aCopy . getBuf fer ( ) ); 
return *this; 

irtual void setLengtht int length ) 

_length = length; 

irtual void setBuffert const char 
*buffer ) 

if ( buffer ) 
{ 

_buffer = new 

char[strlen(buffer)+l] ; 
memcpyt _buffer, buffer, 

strl en ( buffer ) ) ; 

1 

el se 

.buffer = NULL; 

irtual int getLengtht void ) const 

return _length; 

irtual const char *getBuffer( void ) 
const 

return _buffer; 



int maint ) 
{ 

std: :vector<My Buffer, MyAl loc<My Buffer) 
> myVector; 

const char *sl = "Hello world"; 

const char *s2 = "Goodbye cruel world"; 

const char *s3 = "Hello again world"; 



MyBuffer ml ( strl en ( si ) , si) 
MyBuffer mZ ( strl en ( sZ ) , sZ) 
MyBuffer m3 ( strl en ( s3 ) , s3) 



my Vector . i nsert ( my Vector . end () , ml ) 
myVector . i nsert ( my Vector . end () , mZ ) 
myVector . i nsert ( my Vector . end () , m3 ) 
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Our test driver simply exercises some of the 
more basic constructs of a container, creating a 
fgwjiew objects and adding them to a vector. 

ed when it goes out of 
e diagnostic print messages 
to illustrate when the various pieces of code in 
the MyBuffer class are called. 

6. Save the source file in the editor and close the 
editor application. 

7[ Compile the application with the compiler of 
your choice on your favorite operating system. 

If you have done everything right, you should get 



something similar to the output shown in Listing 50-3 
when you run the program in your console window. 

Listing 50-3: Output from the Test Driver 


$ ./a.exe 






MyBuffer 


Ful 1 


Constructor 


5 


MyBuffer 


Ful 1 


Constructor 




MyBuffer 


Ful 1 


Constructor 




al 1 ocate 


1 el em 


snt(s) of size 12 


6 


allocated at: 


3xa050768 




MyBuffer 


Copy 


Constructor 




al 1 ocate 


2 el em 


;nt(s) of size 12 




allocated at: 


3xa050788 




MyBuffer 


Copy 


Constructor 




MyBuffer 


Copy 


Constructor 




MyBuffer 


Destr 


jctor 




deallocate 1 el 


3ment(s) of size 12 


at: 




0xa050768 
locate 4 element 
llocated at: Oxa 



MyBuffer 
MyBuffer 
MyBuffer 
MyBuffer 
MyBuffer 
deallocate 2 e 
0xa050788 



Copy Con 
Copy Con 
Copy Con 
Destruct 
Destruct 
erne 



(s) of size 12 

0507d0 

structor 

structor 

structor 

or 

or 

nt(s) of size 12 at: 



MyBuffer 
MyBuffer 
MyBuffer 
MyBuffer 
MyBuffer 
MyBuffer 
deal 1 ocate 4 e 
0xa0507d0 



Destructor 
Destructor 
Destructor 
Destructor 
Destructor 
Destructor 

ement(s) of size 12 at: 



The display shows the allocator doing its job, 
telling us just when everything is being allocated 
and destroyed. The messages we placed in the 
constructor are printed out (seen at -* 5) from 
the construction in our main program. The allo- 
cator memory allocation is shown at -* 6. This 
corresponds to the call to insert in the vector 
called my Vector in the main function. As each item 
is placed into the array, a new object is allocated 
by the allocate method and then the object is 
copied into that block, as shown at -> 7. Finally, 
the vector goes out of scope and the deal 1 ocate 
method is called, as shown at -»• 8. This calls the 
destructors for the class, as shown in the output. 

Always build a debugging version of allocation 
(with diagnostic printouts) for your programs 
so you can track memory leaks (and overall 
memory usage). 
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Preventing memc 


ry leaks 


caused by overwritten 


pointers 




Introducing the a 


uto_ptr 


class 




Implementing the 




auto_ptr class 




Interpreting the output 




There are numerous products on the market for detecting and 
resolving memory leaks. And in this book, I have included several 
techniques for discovering memory leaks as well. However, the 
best way to handle memory leaks is to not have them in the first place. 
Defensive programming techniques can avoid memory-leak problems and 
save you immense amounts of time and trouble in the long-run. 



Rather than try to find and fix problems as they occur, you'd be bet- 
ter off utilizing techniques that avoid the problem in the first place. 
This way you have more time to spend on solving problems directly 
related to user interaction and needs and less time to worry about 
trivial problems that must be fixed before you can get to those issues. 



One of the most insidious memory leak issues is that of pointers that 
are overwritten or failed to de-allocate. If a pointer is not de-allocated, a 
memory leak will occur. If enough memory leaks occur, your program will 
not be able to allocate new memory and will likely crash. With overwrit- 
ten pointers, the memory that they point at is not the same memory that 
was allocated. As a result, the original memory is not de-allocated, which 
causes the memory leak problem. Alternatively, the overwritten pointer 
may point at something important in memory, and when it is dereferenced 
and used to modify that memory, it will cause a program crash. The STL 
provides a wonderful tool for avoiding this particular problem: the 
auto_ptr class. This class ensures that a pointer is always deleted when 
its work is done, even if it has been copied over, ignored, or transferred 
to an orphan object. This technique explores how to use the auto_ptr 
class to avoid problems in your own code. 



Using the auto_ptr Class 

The auto_ptr class makes code cleaner by removing the need to check for 
allocations and de-allocations of objects all over your code. Let's look at 
the steps necessary to use the auto_ptr class in your own code. Essentially, 
there is only one real "step" involved, which is to wrap an allocated pointer 
in an auto_ptr template object. We will see how the object is allocated and 
then freed when the auto_ptr template object goes out of scope. 
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f m In the code editor of your choice, create a new 
file to hold the code for the technique. 

It tBi^gafl^jll, ji\^\c is named ch51 . cpp, 

thlfeyjTOyTA.^fr whatever you choose. This 
file will contain the source code for our classes. 

2, Type the code from Listing 51-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 51-1: Using the auto ptr Class with Your Own 
Functions 

//include <iostream> 
//include <memory> 

using namespace std; 

class Tracker 

{ 

private: 

static int _al 1 ocati ons ; 

stati c i nt _f rees ; 
public: 

Tracker( void ) 



_al 1 ocati ons ++; 
Tracker( const Tracker& aCopy ) 
_allocations ++; 
Tracker( ) 
_frees ++; 

static int Al 1 ocati ons ( ) 

return _al 1 ocati ons ; 

stati c i nt Frees ( ) 

return _frees; 

static void reset( ) 

_allocations = 0; 
_frees = 0; 



static void reportO 

{ 

cout << "Tracker Class:" << endl ; 

cout << "Allocations: " << _alloca- 

ti ons << endl ; 

cout << "Frees: " << _frees << endl; 



i nt Tracker : 
i nt Tracker : 

voi d Tuncl ( ) 



_al 1 ocati ons 
_frees = 0; 



0; 



Tracker tl; 

Tracker *t2 = new TrackerO; 

Tracker t3 = *t2; 

Tracker t4 = tl; 

t2 = new Tracker( ) ; 



voi d Tunc2( ) 
{ 

Tracker tl; 

auto_ptr<Tracker> t2( new Tracker ): 
Tracker t3 = *t2; 
Tracker t4 = tl; 

t2.reset( new Tracker ); 

I 

void cal l_an_exception_Tunction( ) 
( 

throw 1; 

} 

voi d Tunc3( ) 
{ 

Tracker *t = new Tracker; 
cal l_an_exception_Tunction( ) ; 
delete t; 

} 

voi d Tunc4( ) 

{ 

auto_ptr<Tracker> t(new Tracker); 
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cal l_an_exception_function( ) ; 



DropBooks 



cout << "Running function 1:" << endl 
fund ( ) ; 

f racker : : report ( ) ; 
f racker : : reset ( ) ; 

cout << endl ; 

cout << "Running function 2:" << endl 
func2( ) ; 

Tracker : : report ( ) ; 
Tracker : : reset ( ) ; 

cout << endl ; 

cout << "Running function 3:" << endl 
try 

{ 

f unc3 ( ) ; 

} 

catch (...) 
{ 

} 

Tracker : : report ( ) ; 
Tracker : : reset ( ) ; 

cout << endl ; 

cout << "Running function 4:" << endl 
try 

{ 

f unc4( ) ; 

} 

catch (...) 

{ 

} 

Tracker : : report ( ) ; 



Our test code illustrates two separate ways in 
which memory can be leaked: 

► You can forget to de-allocate a pointer, 
as shown in the fund function at -> 1. 
In this case, we are simply allocating a new 



object and never freeing the object, which cre- 
ates a memory leak. The function called f unc2, 
labeled -> 2, shows the same code using an 
auto_ptr class rather than a plain allocation. 

► You can allocate and free an object, but 
because the function calls something that 
throws an exception, the de-allocation line will 
never be run and a memory leak will occur. 
This more subtle memory leak is shown in 
function f unc3 at -* 3. Function f unc4 shows 
the same basic code using an auto_ptr tem- 
plate instead, as shown in the line marked -* 4. 



3, Save the source code in your editor and close 
the editor application. 


4, Compile the application using your favorite 
compiler on your favorite operating system. 


S. Run the application in the 


console window. 


If you have done everything right, the application 
should give you the output shown in Listing 51-2. 


Listing 51-2: Output from the auto_ 


ptr Test Program 


$ ./a.exe 

Running function 1: 
Tracker Class: 
Allocations: 5 
Frees: 3 




Running function 2: 
Tracker Class: 
Allocations: 5 
Frees: 5 




Running function 3: 
Tracker Class: 
Allocations: 1 
Frees: 0 




Running function 4: 
Tracker Class: 
Allocations: 1 
Frees: 1 
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As you can see from the output, the class Tracker 
tracks how many times the various constructors are 
called, £fid how many times the destructor is called 
^"hoffltaiVt^done via the Tracker 
^BTeifaecI, ss^Aown in Listing 51-1 at -* 5. 
Note that we reset the count each time, using the 
reset function as shown at -* 6. In an ideal situation, 
with no memory leaks, the numbers for allocations 
and frees should be the same. For functions fund 
and f unc3, the allocation and free numbers are not 
the same, indicating a memory leak. For functions 
f unc2 and f unc4, the auto_ptr cases, the allocations 
and frees match up, indicating that there was no 
memory leak. 

The functions we invoke here (fund, f unc2, f unc3, 
and f unc4) show the various ways in which memory 
can be leaked in an application. As you can see, the 
"normal" way of doing things results in numerous 
insidious memory leaks that are hard to track down. 
Compare the auto_ptr cases, which, even with 
exceptional events, always free their memory. 



Rules for using the auto_ptr class 

There are no free lunches in the programming world, and 
the auto_ptr class is no exception to that rule. There are 
certain times you should not use an auto_ptr, and certain 
rules you must understand — such as the following: 

You cannot use auto_ptrs in standard template 
collections such as the STL. Because the STL does 
not follow the standard rules for copying objects, 
auto_ptrs will not be destroyed properly. The 
designers of the STL made this choice and actually 
created templates that would not compile with 
auto_ptrs. 

u* If you copy an auto_ptr, you must not use the orig- 
inal again, as the pointer is transferred from one 
object to the other. 

v 0 The copy constructor for an auto_ptr is completely 
different than the copy constructor for a normal 
object or pointer. Do not treat them equivalently. 
Auto_ptr copy constructors transfer control of the 
pointer they contain, they do not make copies of it. 

Other than that, the class is really a godsend for program- 
mers. When you are working with pointers, use the 
auto_ptr class early and often in your programming 
applications. 
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Memory overwrites are a bane of the C++ programmer. A memory 
overwrite occurs when you write to an area outside an allocated 
block. This is bad, since you are writing to a block of memory 
that you may or may not own, but certainly did not intend to modify. For 
example, if we have a C++ statement that says 

char 1 i n e [ 1 0 ] ; 

and we then write something that says 

1 ine[ll] = 'a ' ; 

we have overwritten a valid part of memory and might cause problems in 
the application later on. Unfortunately, memory overwrites like this are 
somewhat hard to track down without specialized tools and software. 
Alternatively, of course, you can simply avoid writing outside the valid 
bounds of an array or allocated block, but that is a bit easier said than 
done. The real problem here is that when we write to position 1 1 of the 
ten-block array, we have overwritten something in memory. That some- 
thing could be another variable, it could be the return address for a func- 
tion, or it could be a pointer that was previously allocated. None of these 
are good things. You need to stay within the memory allotment that you 
have requested for a memory block. 

This technique looks at a way to use the C++ coding concepts to protect 
the data we are working with from being overwritten. This is a basic con- 
cept of encapsulation in C++: If you have data, you need to make sure that 
the data is used properly. That means not assigning values outside a valid 
range; it also means not overwriting bounds that have been established. 



Creating a Memory Safe Buffer Class 

The most common memory overwrite case occurs when strings are 
copied and assigned values. This error, which typically shows up with 
the use of the C functions strcpy and memcpy, occurs because the func- 
tions do not "know" how big a string is, so they cannot protect against 
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the string boundaries being overwritten. In order to 
fix this problem, we will create a class that under- 
stands jj^own boundaries and only allows the cor- 

I Kr^l^T^r^S fVH^^5 to De written to or copied 
I Vtf ikjf iMtejsof. V^rlsYlSbf, we will create a generic 
buffer class that can be safely used to store strings 
in all of your applications, saving you time in imple- 
menting the class and in debugging memory over- 
writes. Here's how: 



f m In the code editor of your choice, create a new 
file to hold the code for the technique. 

In this example, the file is named ch52 . cpp, 
although you can use whatever you choose. This 
file will contain the source code for our classes. 

2, Type the code from Listing 52-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 52-1: The Buffer Class 



#include <iostream> 
#include <fstream> 

using namespace std; 

class Buffer 
{ 

pri vate : 

char *_buffer; 
long _length; 

vi rtual voi d Ini t( ) 
{ 

_buffer = NULL; 
_length = 0; 

I 

vi rtual voi d CI ear( ) 
( 

if ( _buffer ) 

delete [] _buffer; 
Ini t( ) ; 

} 

publ i c : 

Buffer(void) 
{ 

Ini t( ) ; 

) 

Buffer( const char *buffer, int length ) 
{ 

Ini t( ) ; 

SetBuffer( buffer, length ); 

) 

Buffer ( int length ) 
{ 

_buffer = new char[l ength] ; 
_length = length; 
set( 0 ); 



3uffer( const Buffer& aCopy ) 
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I 

Initn ; 

SetBuffer( aCopy ._buf f er , aCopy ._1 ength ); 

Dropf?©oks 

if ( _buffer ) 

delete [] _buffer; 

} 

Buffer operator=(const Buffer& aCopy ) 

{ 

ClearO; 

SetBuffer( aCopy ._buf f er , aCopy ._1 ength ); 
return *this; 

} 

Buffer operator=(const char *buffer ) 

{ 

ClearO; 

SetBuffert buffer, strl en ( buf f er ) ); 
return *this; 

} 

char& operator[]( int index ) 

{ 

if ( index < 0 || index >= _1 ength ) 

throw "Buffer: Index out of range"; -* 4 

return _buffer[ index ]; 

} 

Buffer operator ()( i nt st, int end) 

// Validate the pieces. 

if ( st < 0 | | st >= J ength ) 

throw "Buffer: Start index out of range"; 
if ( end < 0 | | end >= _length ) 

throw "Buffer: End index out of range"; 
Buffer b( _buffer+st, end-st+1 ); 
return b; 

} 

void sett char c ) 

{ 

for ( int i=0; i <_1 ength; ++i ) 
_buffer[i] = c; 

} 

virtual void SetBuffert const char *buffer, int length ) 

{ 

_buffer = new char[ length ]; 
for ( int i=0; i<l ength; ++i ) 

_buffer[i] = buffer[i]; 
_length = length; 

} 

void emptyt) 

(continued) 
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Listing 52-1 (continued) 



Drop Backs 



return _length; 



ostream& operator <<( ostream& out, Buffer &b ) 

{ 

for ( int i=0; i <b . Length () ; ++i ) 

out << b[i ] ; 
return out; 



voi d fund ( ) 

{ 

char *buffer = new char[10]; 

strcpy( buffer, "This is a really long string"): 
cout << "Fund: [1]" << buffer << endl ; 
memset( buffer, 0, 11 ); 
cout << "Fund: [2]" << buffer << endl; 
strcpyt buffer, "This is a short string"); 
buffer[ 12] = 0; 

cout << "Fund: [3]" << buffer << endl; 

} 

void func2() 

{ 

Buffer b(10) ; 
try 

{ 

b = "This is a really long string"; 
cout << "Func2: [1]" << b << endl; 
b.set( 0 ); 

cout << "Func2: [2]" << b << endl; 
b:i2] = 0; 

cout << "Func2: [3]" << b << endl; 

} 

catch (...) 

{ 

printfC Except i on caught\n"); 



int main( ) 

{ 

fund ( ) ; 
func2( ) ; 

} 
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The two functions shown above illustrate the 
memory overwrite problem, first as addressed 
the standard C++ allocation of arrays (fund, 
J~/"\1| jind^iien using our Buffer class to 
Hg^[f unc2, shown at -> 2). In 
each case, we allocate a character buffer of ten 
characters. In the fund case, we then copy a 
string that is much longer than ten characters 
into the buffer. This causes a memory overwrite 
and could easily crash your program. However, 
because standard C++ has no way of detecting 
this, you will not see the problem immediately. In 
the second case, f unc2, we are using our Buffer 
class, which detects the problem as soon as you 
try to copy the larger string into the small allo- 
cated buffer and report it. 

3. Save the source code in your code editor and 
close the editor application. 

4. Compile the application, using your favorite 
compiler on your favorite operating system. 

5. Run the application in the console window. 

If you have done everything right, you should see 
something similar to this output from the application: 



$ .Is,, exe 

Fund: [ 1 ] T h i s is a rel 

Fund: [2] 

Fund : [3]Thi s is a sh 

Func2: [l]This is a real 

Func2: [2] 

Func2: [3] 



ly long string 



Note that you may see different output on different 
operating systems, depending on how the error 
occurs and whether or not it is visible. For fund, 
we see that the string does not get set to what we 
expect it to. You might see the string "This is a really 
long string" which would be even worse. In the f unc2 
case, however, we never assign the strings that are 
too long, because an exception is thrown and the 
code properly handles it. 

As you can see, in the "pure" C-style access code 
(shown at -* 1), there are no checks to see whether 
the programmer overwrites the buffer that is allo- 
cated. Obviously, in your own code it would not be 
quite as straightforward to find the problem. There 
do not appear to be any problems with the code 
here; everything prints out and continues process- 
ing properly. However, damage has been done to 
structures in memory — and these might or might 
not show up as program crashes. Worse, you might 
give the user incorrect output upon which they may 
make invalid decisions. 

In the second case, C++ style (shown at -* 2), you can 
see that the code protects against overwrites and 
throws an exception (shown at the line marked -> 4 
and caught at the line marked -* 3) when an invalid 
write occurs. This allows the programmer to imme- 
diately find where the problem happened and to fix 
it quickly and easily. 
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C++'s exception handling ability is a feature that differentiates it from 
virtually all older programming systems. As with Java, C#, and other 
modern programming languages, C++ offers the ability to jump out 
of the middle of a block of code when an exceptional event occurs. 

The concept of an exception handling is really quite simple. In older pro- 
gramming languages, when errors occurred, an error code was sent to 
the calling application, which could — and often did — simply ignore it. 
Exception handling changes this. It forces the application developer to 
consider in advance what could go wrong in the lower-level code, and to 
provide routines to contend with any errors that crop up. Now when an 
error — that is, an exception — occurs, the program passes control to the 
appropriate predefined routine. Error handling ensures that errors aren't 
ignored; they're dealt with. 

This technique takes a closer look at throwing and catching exceptions. 
First, we examine throwing an exception and logging it in a generic fashion. 
Logging errors is important because it allows you to provide a complete 
debugging log that can be used to see what went wrong when a problem 
occurs. This will save you time and effort in debugging your application, 
and results in better code for the end-user. 



Throwing and Logging Exceptions 

In order to best understand how to use exception handling in your own 
applications, let's look at a simple example of throwing exceptions in 
which those exceptions are logged to an output error file that can be used 
for debugging purposes. To do this, we will need two different types of 
classes. 

We need a class to hold the information about what went wrong. This 
class will contain the line number where the error occurred and infor- 
mation detailing the nature of the error. 

*>* We need a class that will manage the process of catching the exception 
and logging the information into an error log. 
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The following steps show you how this is done: 

he code editor of your choice, create a new 
for the technique. 



f m Injhe code editor oi 

Drop Backs 

In this example, the f 



this exampFe, the file is named ch53 . cpp, 
although you can use whatever you choose. This 
file will contain the source code for our classes. 



2. Type the code from Listing 53-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 53-1: The Exception Handling Classes 



#include <iostream> 
^include <string> 
#include <fstream> 
#include <stdio.h> 

using namespace std; 



class Excepti onCl ass 
{ 

string ^message; 
string _f i 1 e ; 
1 ong _1 i ne ; 
publ i c : 

Excepti onCl ass ( voi d ) 



_message = "Unknown Exception"; 

) 

Excepti onCl ass ( const char *msg, const char *fileName, long lineNo ) 



.message 
_file 
1 i ne 



msg; 

f i 1 eName ; 
1 i neNo ; 



) 

Excepti onCl ass ( const Except! onCl ass& aCopy ) 
{ 

_message = aCopy ._message ; 
_file = aCopy._file; 
_1 i ne = aCopy ._] i ne ; 



void setMessage( const char *msg, const char *fileName, long lineNo ) 



.message = msg; 
_file = fileName; 
J i ne = 1 i neNo ; 



(continued) 
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Listing 53-1 (continued) 



virtual string Report(void) const 



DropBaoks 

m 1 1 -t-= f i 1 o 



i on reported i n file " ; 
out += _f i 1 e . c_str ( ) ; 
out += " at 1 i ne " ; 
out += _1 i ne ; 
return out; 

) 

virtual ostream& Report( ostream& out ) const 

{ 

out << "Exception reported in file " << _f i 1 e . c_st r ( ) << " at line " << _line << endl 
out << _message.c_str( ) << endl; 
return out; 



class Excepti onCatcher -* 2 

{ 

private: 

string _message; 

ofstream _logFile; 

string _fileName; 
publ i c : 

Excepti onCatcher( void ) 

{ 

string msg = "Startup"; 

LogMessage( msg ) ; 

I 

Excepti onCatchert const char *fileName ) 
: _logFile( fileName ) 

{ 

string msg = "Startup"; 
msg += " [ " ; 
msg += fileName; 
msg += " ] " ; 

LogMessage( msg ) ; 

I 

Excepti onCatcher( const Excepti onCatcher& aCopy ) 
: _logFile ( aCopy ._f i 1 eName . c_s t r ( ) ) 

{ 

_fileName = aCopy ._fi 1 eName ; 
_message = aCopy ._message ; 
string msg = "Startup"; 
msg += " [ " ; 
msg += _f i 1 eName ; 
msg += " ] " ; 
LogMessaget msg ) ; 
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} 

Excepti onCatcher ( const Excepti onCl ass& exception ) 

{ 

^^xcepti on . Report () ; 

prT onCatcher ( ) 

{ 

string msg = "Shutdown"; 

LogMessage( msg ) ; 

} 

virtual void LogMessaget string msg ) 

{ 

if ( MogFile.fail () ) 

_logFile << msg.c_str() << endl ; 

I 

virtual void LogMessaget const Excepti onCl ass& exception ) 

{ 

if ( MogFile.fail () ) 
{ 

excepti on . Report ( _logFile ); 




I ; 

void process_opti on ( int x ) 

{ I 
if(x<2||x>8) 

throw "Invalid Input to process_opti on" ; 

int z = 10 / x; 

cout << "Properly processed option " << x << endl; 

} 

int funcK int x) 
throwt Excepti onCl ass ) 

{ 

Excepti onCl ass ec; 

try 

{ 

switch ( x ) 
{ 

case 0: 

cout << "You selected the first option" << endl; 
break; 
case 1: 

cout << "You selected the second option" << endl; 
break; 
case 2: 

process_opti on ( x ) ; 

(continued) 
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Listing 53-1 (continued) 



def aul t : 



ec . setMessage( "Invalid Option", FILE , LINE ); 



catch ( const char *msg ) 
{ 

string sErr = "Unknown Error: "; 
sErr += msg; 

ec . setMessage( sErr . c_str( ) , FILE , LINE ); 

throw ec; 

) 

return 0; 



int main(int argc, char **argv) 
{ 

if ( argc < 2 ) 
{ 

cout << "Usage: ch6_9 <inputs>" << endl ; 

cout << "Where: inputs is a series of numbers" << endl; 

return -1; 




Except i onC ate her catcher ( "errors . 1 og" ) ; 



// Process 
for ( int i 



the inputs. 

=1; i<argc; ++i ) 



int iVal 
try 



= atoi ( argv[i ] ) ; 



funcKiVal ) ; 



catch ( Excepti onCl ass& ec ) 



ec . Report( cout ) ; 
catcher . LogMessage( ec ); 



catch ( 



cout << "Caught an exception" << endl; 



return 0; 

) 
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and then utilize the in 

Droproote 



J. 
4. 
5. 



The purpose of this code is to illustrate how to 
handle an error, log the error to an output file, 
ind then utilize the information in that file to see 
ring. Our test driver simply 
Iter several options from 
the command line and then passes them to a 
selector function that decides what to do based 
on that input. If the input is within range, it is 
processed. Otherwise, an exception object is 
built indicating what problem occurred and 
where. In this case, our error object will show 
all times in which the user entered a value out- 
side the valid range. To do this, we use the 
Excepti onCl ass class, shown at -* 1. This class 
simply holds the error information, and allows 
the application to retrieve it. It also provides a 
reporting function to format the information in a 
user readable way and to print it out. The second 
class, the Excepti onCatcher (shown at -* 2) just 
takes the information from the Excepti onCl ass 
object and prints it to the file specified in its con- 
structor. Note that when an error occurs, it is 
propagated up to the main program, and caught 
at-> 3. 

Save the source code in your code editor and 
then close the editor application. 

Compile the application, using your favorite 
compiler on your favorite operating system. 

Run the application in the console window. 



Hi 



If you have done everything right, you should see 
the following output from the application: 

$ ./a.exe 12 3 

You selected the second option 

Properly processed option 2 

Exception reported in file ch53.cpp at 

1 ine 138 
Invalid Option 

Exception reported in file ch53.cpp at 

line 138 
Invalid Option 



Note that the filename shown will vary 
depending on the program name you have 
chosen and the operating system you are 
working on. 



In addition, you will have a file in your file system 
called errors. log. This file should contain the fol- 
lowing entries in it: 

$ cat errors.log 
Startup [errors.log] 

Exception reported in file ch53.cpp at 

line 138 
Invalid Option 

Exception reported in file ch53.cpp at 

line 138 
Invalid Option 
Shutdown 

The output above indicates that there were errors 
detected in the program, which is to be expected 
because we gave the input invalid values. For the 
values that were understood, the message Properly 
processed option followed by the option number is 
displayed. For all other values, an exception is gen- 
erated and the error Invalid Option is displayed. 



Beating With Unhandted 
Exceptions 

Exception handling is a good thing, but sometimes 
an exception type pops up that you were not expect- 
ing. This is particularly problematic when you're 
working with third-party libraries that either change 
over time or poorly document the exception types 
they throw. There is obviously nothing you can do 
about an exception type that you know nothing 
about — but you can at least stop your program 
from behaving badly when one is thrown. 

The following steps show you an example of an 
exception that isn't handled properly (a divide- 
by-zero error) and how you can use the built-in 
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tio 

Dra 



set_termi nate function to deal with it before it can 
lead to memory leaks and the like in your applica- 
tion. Th£^et_termi nate function defines a user- 
* Jaftljgt will be called before 
l^ft/lfirewiction can be used to 
de-allocate any allocated blocks of memory or to 
close any open files or to do any other last minute 
handling that needs to be done to make your pro- 
gram shut down cleanly 




f m In the code editor of your choice, reopen the 
source file to hold the code for the technique. 

In this example, the file is named ch53 . cpp, 
although you can use whatever you choose. 

2, Add the code from Listing 53-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 53-2: Using set terminate in Your Application 



int *gAl 1 ocatedBuffer = NULL; 

void term_func( ) 
{ 

cout << "term_f unc( ) was called by termi nate( ) . \n " ; 

// Do our global cleanup here, 
delete [] gAl 1 ocatedBuffer ; 

// We MUST call exit, because the terminate routine will abort 
// otherwise. 
exit(-l) ; 



int func2( void ) 
{ 

set_termi nate( term_func ); 

try 

{ 

int i = 10; 
int j = 0; 
int x = 0; 

if ( j != 0 ) 
x = i / j ; 

el se 

throw "Error: Division by Zero!"; 

} 

catch ( Excepti onCl ass& ec ) 
{ 

cout << "Exception Caught" << endl ; 



I 
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Also, remember to add a call to f unc2 in your 
main function so that we can look at the output 
f_the program. After you do this, you will see 
function is invoked, it 
ro error (shown at -> 4 
in Listing 53-2), which would normally crash 
the program without freeing the allocated 
gAl 1 ocatedBuf f er memory block back to the 
operating system. Instead, we check for the 
error, throw an exception that is caught by the 
compiler-generated code, and then call the termi- 
nation function. 

Note that we are throwing an exception that con- 
tains a character string, but catching only the 
exceptions of type Except i 0 n C 1 a s s . The two will 
not match — which means the code for catching 
the exception will be bypassed. 

3. Save the source code in your code editor and 
then close the editor application. 

4. Compile the application, using your favorite 
compiler on your favorite operating system. 

5. Run the application in the console window. 



Re-throu/ing Exceptions 

One of the most annoying things about traditional 
error handling in C and C++ is that it forces you to 
lose a lot of lower-level information. For example, if 
you call a function to read a record, which in turn 
calls a function to move to the record in the file, 
which in turn calls a function to seek to the offset in 
the file (which causes an error), some potentially 
useful lower-level information (the fact that the off- 
set was invalid) is lost at the top level. All you know 
is that the function to read a record failed, and possi- 
bly that it failed in the move routine. You still have 
to sit down with a debugger and step all the way 
down into the lowest-level functionality to see what 
really happened in the code. We can fix this by 
chaining errors from the lowest level to the upper- 
most level of an application. This chaining effect is 
accomplished by rethrowing exceptions. 



If you have done everything right, you should see 
the following output from the application: 

$ ./a.exe 12 3 

You selected the second option 

Properly processed option 2 

Exception reported in file ch6_9.cpp at 

1 ine 138 
Invalid Option 

Exception reported in file ch6_9.cpp at 

line 138 
Invalid Option 

term_f unc( ) was called by termi nate( ) . 

Note that the term_f unc was called because an 
unhandled exception was generated by the code and 
never caught by the application code. If we did not 
install our own termination function, the program 
would simply exit and you would never see the 
term_f unc function call in the output. 




Exception handling is a sure way to make sure 
that an error is handled in an application. If 
you design your application (from the ground 
up) to use exception handling, you save time 
later on by simplifying the debugging and 
maintenance phase of the system. 



With exception handling, however, you can pass the 
information up the chain so the highest-level func- 
tion can report all the data for a given error from the 
bottom level to the top. 

In order to pass information from a lower level of the 
application to a higher one, you must catch excep- 
tions, append to them and rethrow them. In the fol- 
lowing list, I show you exactly how you do that, from 
generating the initial exception to catching it and 
adding to it to pass it to a higher level. 
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f m In the code editor of your choice, reopen the 
source file to hold the code for the technique. 



Drop©OTte 



le is named ch53 . cpp, 
whatever you choose. 



2. Add the code from Listing 53-3 into your file. 

Or better yet, copy the code from the source file 
on this book's companion Web site. 



Listing 53-3: Passing Exceptions to a Higher Level 



int read_file( long offset ) 
throw(string) 

{ 

if ( offset < 0 || offset >= 100 ) 

throw st ri ng( " read_f i 1 e : Invalid offset"); 
return 0; 



int read_record( long record ) 
throw(string) 



f ( record < 0 | | record > 10 ) 

throw stri ng( " read_record : invalid record number"); 
ong offset = record * 10; 
try 

read_f i 1 e( offset ) ; 

catch ( string msg ) 

string sMsg = " record_record : unable to go to offset\n"; 
sMsg += msg; 
throw sMsg; 



return 0; 



! 



int func3(long recno) 

{ 

try 

read_record( recno ); 

catch ( string s ) 

cout << "func 3: Error in read:" << endl ; 
cout << s.c_str() << endl; 

catch (...) 

cout << "func 3: Unknown error in read:" << endl 



cout << "End of func3\n" 

} 



Re~throWing Exceptions 




3. 



In this example, we first catch an error at the 
lowest level, the read_f i 1 e function, and gener- 
an exception that is thrown to the 

^/ n l c l fll, 4 b'Sti* 11 ' as shown at -> 5. This 
rVi^Hy/<p\g^in the read_record function, 
but the fact that the read_record function fails 
trying to read the data is added and the error is 
then rethrown, as shown at -* 6. The error is 
then caught at a higher level, in the f unc3 func- 
tion (as shown at -* 7), and the results are dis- 
played for the user. 

In the main function, modify the code to call 
our new function, adding a call to f unc3 wher- 
ever you would like in the code, as follows: 

//func2( ) ; 

cout << "Func3 [1]" << endl ; 

func3(2) ; 

cout << "Func3 [2]" << endl; 



4. 
5. 
6. 



func3(10) ; 

cout << "Func3 [3]" << endl; 
func3(20) ; 

Note that the f unc2 call has been commented 
out, because it exits the program. This is easy to 
overlook; if your program never hits the f unc3 
calls, it's probably because you forgot to com- 
ment out this line. 

Save the source code as a file in your code edi- 
tor and then close the editor application. 

Compile the application using your favorite 
compiler on your favorite operating system. 

Run the application in the console window. 



If you have done everything right, you should see the 
output from the application as shown in Listing 53-4. 



Listing 53-4: Updated Output from the Exception Handling Program 



$ ./a.exe 1 2 3 

You selected the second option 
Properly processed option 2 

Exception reported in file ch6_9.cpp at line 138 
Invalid Option 

Exception reported in file ch6_9.cpp at line 138 
Invalid Option 
Func3 [1] 
End of func3 
Func3 [2] 

func 3: Error in read: 

record_record : unable to go to offset 

read_file: Invalid offset 

End of func3 

Func3 [3] 

func 3: Error in read: 
read_record: invalid record number 
End of func3 
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As you can see from the line marked with -*■ 8 in the 
above output listing, the function f unc3 generates 
the entia^error string, rather than a simple notation 

TfcJnWttCo/Tfc^Vs^ C^ m tnis ' we can see how 
*nipif nwreV^f\i«t'isV;V?ee the entire history of 
what went wrong rather than simply that an error 
occurred. 

Some caveats about exception handling 

While exception handling is a wonderful thing and deals 
with many of the problems that are inherent in our C++ 
programs today, there are a few issues you should be 
aware of before you leap into using it everywhere. 

Exception handling is not cheap; it costs you speed 
and processing power. Every time you throw an 
exception, the entire stack must be unwound, all 
proper destructors called, and the proper handler 
found and called. 

Exception handling can result in unintended memory 
leaks if an exception is thrown at the wrong moment. 
For example, consider the following: 

void func(char *strln) 
( 

char *buffer = new char[80]; 
if ( strln == NULL ) 
throw "Bad i nput" ; 

// Process input 

delete [] buffer; 

1 

If you call this function with a NULL pointer, it causes 
a memory leak because the buffer array is never 
de-allocated. 

Never use an exception type whose copy construc- 
tor could throw an exception. This includes strings, 
and some STL container classes. Always make sure 
that the copy constructor is exception-safe before 
using it. If you do not follow this rule, you will cause 
problems with recursive error handling. 

Some C++ compilers cause the exception object to be 
deleted twice. Make sure that any exception class you 
write is safe: Clear out all pointers in the destructor. 
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Failing to handle errors is the single biggest reason for program 
failure — and that's what creates the need for debugging and main- 
tenance. If you eliminate the source of failures, you will give yourself 
more time for developing better classes of applications and better fea- 
tures for your users. In this technique, I show you how to combine return 
codes with exception handling to avoid these failures. 

In C++, methods and functions can return a status code that says whether 
the function succeeded, failed, or was left in some in-between state. For 
example, we might have a function that returns a status code indicating 
where the method is in processing data. The status code returned may 
look something like this: 



int get_status ( voi d ) 



switch ( current_status ) 



case 


N 


otProcessing: 






return -1; 


case 


I 


nProcessing: 






return 1; 


case 


Processi ngComp 






return 0; 



return -99; 



Now, in this example, if the function returns a value of -99, obviously 
something very bad is going on — because we have no idea what state 
the object might have reached. Normally, if the status code were -99, we 
would want to stop processing immediately — and possibly exit the pro- 
gram. Unfortunately, there is no way for the developer of the function to 
force the developer using the function to check the return status code to 
make sure that they know something has gone wrong. Wouldn't it be nice 
if there was a way to ensure that the programmer looked at the return 
code to see if it was invalid or not? 
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As it turns out, you can make sure that the devel- 
oper checked the return codes. By using the follow- 
ing stepj^ou can force the return code to be 

|ffl|<|(T?telj^h^hecked, you can throw an 
'tfenfBul WffefljWe best of all possible 
worlds. Exception handling is a very sure way to 
force the developer to handle errors, but it also has 
a large overhead in terms of processing speed and 
CPU usage. Return codes, on the other hand, have 
low overhead, but you can't really be sure that the 
developer will ever look at them. By combining the 
two approaches, you can be absolutely sure that 
errors are handled, which eliminates most of the 
run-time problems that crop up for end-users. There 



is some overhead involved here, due to the exception- 
handling addition, but that overhead is mitigated by 
the fact that the exceptions will not be thrown if the 
error is properly checked. 

f m In the code editor of your choice, create a new 
file to hold the code for the technique. 

In this example, the file is named ch54 . cpp, 
although you can use whatever you choose. This 
file will contain the source code for our classes. 

2, Type the code from Listing 54-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 54-1: The Return Code Class 



#include <iostream> 
#include <string> 

using namespace std; 

template < class T > 
class RetValue 
{ 

T _val ue ; -* 1 

bool _checked; -* 2 

publ i c : 

RetValue( void ) 
{ 

_checked = false; 

} 

RetVal ue( const T& t ) 
1 

_val ue = t ; 
_checked = false; 

} 

RetVal ue( const RetVal ue& aCopy ) 
f 

_value = aCopy ._val ue ; 
_checked = false; 

} 

virtual -RetVal ue(void) 
1 

if ( !_checked ) 

throw "Error: Return value not checked! 
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bool operator==( const T& t) -*1 




bool operator!=( const T& t) 

{ 

_checked = true; 
return t != _val ue; 

} 

bool operator <( const T& t) 

{ 

_checked = true; 
return _value < t; 

} 

bool operator <=( const T& t) 

{ 

_checked = true; 
return _value <= t; 

} 

bool operator >( const T& t) 

{ 

_checked = true; 
return _value > t; 

} 

bool operator >=( const T& t) 

{ 

_checked = true; 
return _value >= t; 

} 

operator TO 
{ 

_checked = true; 
return _value; 

} 

bool operator ! ( ) 

{ 

_checked = true; 
return !_value; 

} 

T operator&( const T& t ) 

{ 

_checked = true; 
return _value & t; 

} 

T operator] ( const T& t ) 

{ 

_checked = true; 
return _value | t; 

1 

bool IsCheckedO 

(continued) 
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Listing 54-1 (continued) 



return .checked ; 



■ ^ return icnecK 

DropBaoks 



return _val ue ; 



RetVal ue<i nt> func( int iValue ) 

{ 

if ( i Value == 34 ) 

return RetVal ue<i nt>( 1 ) ; 
if ( i Value == 35 ) 

return RetVal ue<int>(2) ; 

return RetVal ue<i nt>( 0 ) ; 



RetVal ue<i nt> func2(int iValue) 

{ 

RetVal ue<i nt> ret = funcd'Val ue) ; 
if ( ret ) 

return ret; 

return RetVal ue<i nt>( 0 ) ; 



class MyReturnVal ue 

{ 

string _message; 
publ i c : 

MyReturnVal ue( void ) 

_message = " " ; 

MyReturnVal ue( const char *msg ) 

_message = msg; 

MyReturnVal ue( const MyReturnVal ue& aCopy ) 

_message = aCopy ._message ; 

MyReturnVal ue operator=( const MyReturnVal ue& aCopy ) 

_message = aCopy ._message ; 
return *this; 

string Message(void) 

return _message; 
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string operator=( const string& msg ) 



bool operator==( const My ReturnVal ue& aValue ) 

{ 

return _message == aVal ue._message; 

} 

bool operator<( const MyReturnVal ue& aValue ) 

I 

return _message < aVal ue._message; 

} 



I ; 

int main( ) 

{ 

try 
{ 



if ( !func( 34 )) 

printft" Success! !\n") ; 
if ( func(35) & 2 ) 

pri ntf ( "Error 35\n" ) ; 
RetValue<int> tl = 5; 
int x = 5; 
int y = 3; 

printf("5 == 5? %s\n", tl == x ? "Yes" : "No" ); 
printf("5 == 3? %s\n", tl == y ? "Yes" : "No" ); 
int iVal = tl; 

pri ntf ( "Cal 1 i ng func2\n"); 
func2(34) ; 

} 

catch (...) 

{ 

pri ntf (" Except i on ! \n" ) ; 

} 



RetVal ue<My ReturnVal ue> rvl = MyReturnVal ue( "Thi s is a test"); 

MyReturnVal ue rv = rvl; 

string s = rv.Message( ) ; 

pri ntf (" Return Value: %s\n", s.c_str() ); 



pri ntf ( " Excepti on in MyReturnVal ue\n" ) ; 




try 



catch ( 



return 0; 

} 
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The base class here, RetVal ue, implements a 
templated return code class that can accept any 
sort of data to.use as the "real" return code for 

is. This code is stored in the 
riable, as shown at -> 1. 
Below that is another member variable called 
checked, which is used to see whether or not the 
return code has ever been compared to anything. 
(See -> 2.) The user can trigger this by compar- 
ing the value of the return code using any of the 
standard boolean operators (such as equal, not 
equal, less than, greater than, and so forth). After 
any of these operators is used, the return code 
knows that the developer using the return code 
has checked it in some way, and allows the pro- 
gram to continue. If the return code object goes 
out of scope without the error being checked, an 
exception will be thrown, as shown at -* 3. 
Because the class is templated, you can store 
anything you want in the class member data. We 
illustrate this by creating our own class, called 
MyReturnValue and returning it from a function. 

3, Save the source code in your code editor and 
then close the editor application. 

4. Compile the application, using your favorite 
compiler on your favorite operating system. 

Run the application in the console window. 

If you have done everything right, you should see 
the following output from the application: 

$ ./a.exe 
Error 35 
5 == 5? Yes 
5 == 3? No 
Calling func2 
Excepti on ! 

Return Value: This is a test 

The output from this little test program shows that 
when we check an error, such as the not (!) operator 
comparison at -* 4 or the logical and (&) operator 
at -+ 5, there is no exception generated by the code. 
However, if a function that returns a RetVal ue 



template object, such as f unc2, is called, as shown 
at -* 6, and the return value is not checked, there 
will be an exception generated. 

As you can see, if the user does not choose to check 
a return value, the destructor for the class throws an 
exception when the object goes out of scope. This 
forces the application developer to deal with the 
problem, one way or the other. If the developer does 
not handle the exception, it terminates the program. 
If the developer does handle the exception, he will 
immediately realize where the return code was not 
handled. 

What's especially handy about this technique is that 
it also illustrates how you can override virtually 
every possible comparison operation for an object 
(such as the operator== shown at -> 7). By checking 
the various operations, we know whether the user 
did something like this: 

if ( method_wi th_return_code ( ) == 
BadReturn ) 



instead of something like this: 

int myRet = method_wi th_return_code ( ) ; 

In the first case, the user is actually checking to see 
if the value was equal to something. In the second 
case, they are assigning the value to another vari- 
able that might never be checked. By looking at how 
the user accesses our return value, we can know 
whether they really checked the return code or not. 
This is where the overloaded operators come in; we 
set the checked flag in the overloaded operator and 
therefore we know whether the result was really 
looked at. 

In addition, you have to worry about things like 
passing return codes up the chain from low-level 
methods to higher level ones. If the user makes a 
copy of the object to add a result or check the 



Enforcing Return Codes 



current result, we want to know about it. They might 
then pass a copy of the object to a higher level call- 
ing routine. The coay constructor for the class is a 
Hf|««TjrTHp|n\>llj£ iQou may have seen or 

nplpassign all of the member 
variables to be the same as the object it copies. 
Instead, it copies the value of the return code, and 
then makes sure that the flag indicating that the 
return value was checked is reset to unchecked, 




because otherwise the user could simply copy the 
object into another return code and never look at 
the "real" status value. 



Make sure that the errors you return to the 
user are as descriptive as possible, including as 
much information as you can. After all, you 
want your users to be able to actually do 
something about the trouble. 
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If you have ever searched for files on a computer, you have probably 
used wildcards. Wildcards, in this sense, are characters used in search 
strings that stand not for themselves but for a broad range of charac- 
ters. The idea of finding all of the files that match a given pattern is 
rather common in the computer world. So is the idea of searching files 
for strings that match wildcard patterns. For example, if you must find a 
file but can't quite recall the name of that file — all you remember is that 
it began with the word convert or conversion or something similar — 
using a wildcard would be a great solution. Searching for the word con- 
vert only pulls up files that began with that specific word. Searching for 
conv*, on the other hand, gives you a much broader selection of files. The 
asterisk (*) wildcard character represents any group of zero or more 
characters. This means the resulting list from your search would include 
files that began with conv and then ended in any group of zero or more 
characters, such as 



Convert 
Conversi on 
Conversati on 



and the like. 



Because they match zero or more characters, asterisks are useful wild- 
cards, but they have their limitations. Using the asterisk, the pattern A*B 
matches AB, AbasdhB, and AbB. It does not match ABC nor AajhaBajksjB. 

Wildcards represent a powerful capability that finds all the words that 
match a given root. Even better, wildcards also allow you to match words 
when you aren't quite sure of the spelling. For example, what if you're 
looking for the word conscious, but you can't recall how to spell it — 
does it have an s in the middle or not? Wildcards allow you to search for 
the term anyway; you just search for con?ci ous. The question mark (?) 
wildcard represents any single character (or none at all); the pattern A?B 
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matches both AB and AbB. So the expression con?ci ous 
matches the word conscious whether or not it 
includetLan s in thai position. 




fmeruVeR 1/aHVw be able to use wildcards 
to filter data. If you give them this capability, 
you can save yourself a lot of time in support- 
ing them. Appropriately used, wildcards can 
help make life a bit easier for everyone. 

The question-mark and asterisk characters are com- 
mon wildcards — but not the only ones. In the SQL 
language, for example, you use a percent sign (%) 
instead of an asterisk to match multiple characters. 
For this reason, when you design a class that per- 
mits wildcards in search strings, you should allow 
that information to be configurable. The purpose of 
this technique is to show you how to create a class 
that performs matching with wildcards. This class 
can be used to quickly and easily add pattern match- 
ing functionality to your application, which saves 
you time and effort in developing quality software 
that users really want. 



Creating the Wildcard 
Matching Class 

In order to best utilize wildcard matching in your 
application, you should encapsulate the functional- 
ity for matching strings into a single class. That class 
will handle both the jobs of storing the match char- 
acters (such as an asterisk or question mark) and 
determining if the two strings match. Let's develop 
such a class and a test driver to illustrate how it is 
used. Here's how: 

f m In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch55 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 55-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 55-1: The Match Class 



#include <iostream> 
#include <string> 

using namespace std; 

class Match 



pri vate : 

char _MatchMul ti pi e ; 
char _MatchSi ngl e ; 
string _pattern ; 
string _candi date ; 

protected : 

bool match(const char *pat, const char *str) 
{ 

if ( *pat == '\0' ) 
return !*str; 

el se 

if ( *pat == _MatchMultiple ) 

return match ( pat+1 , str) || (*str 



match ( pat , str+1 ) ) ; 



(continued) 
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Listing 55-1 (continued) 



else 

if ( *pat == _MatchSingle ) 

eturn *str (match(pat+l , str+1) || match ( pat+1 , str)); 
pat) && match(pat+l , str+1); 
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publ i c : 

Match ( voi d ) 

{ 

_MatchMul ti pi e = ' * ' ; 
_MatchSi ngl e = ' ? ' ; 

} 

Match( const char *pat, const char *str ) 
{ 

_MatchMul ti pi e = ' * ' ; 
_MatchSi ngl e = ' ? ' ; 
_pattern = pat; 
_candidate = str; 

} 

Match( const Match& aCopy ) 

{ 

_MatchMul ti pi e = aCopy ._MatchMul ti pi e ; 
_MatchSingle = aCopy ._MatchSi ngl e ; 
_pattern = aCopy ._pattern ; 

_candidate = aCopy ._candi date ; 

} 

Match operator=( const Match& aCopy ) 

{ 

_MatchMul ti pi e = aCopy ._MatchMul ti pi e ; 
_MatchSingle = aCopy ._MatchSi ngl e ; 
_pattern = aCopy ._pattern ; 

_candidate = aCopy ._candi date ; 
return *this; 

} 

char Multiple(void) 

{ 

return _MatchMul ti pi e ; 

} 

char Single(void) 

{ 

return _MatchSi ngl e ; 

} 

void setMul tipl e( char mult ) 

{ 

_MatchMul ti pi e = mult; 

} 

void setSingle( char single ) 

{ 

_MatchSingle = single; 
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void setPattern( const char *pattern ) 

{ 

_pattern = pattern; 

^^e( const char *candidate ) 
_candidate = candidate; 
tring getPattern( void ) 

return _pattern; 
tring getCandi date( void ) 

return _candidate; 
ool matches ( ) 

return match( _pattern . c_str( ) , _candi date . c_str( ) ); 




The purpose of this class is to see whether or not 
two strings match, including wildcards if neces- 
sary. To accomplish this, we need the following: 

► A multiple character wildcard 

► A single character wildcard 

► An input pattern string 

► The candidate match string 

For example, if we wanted to allow the user to 
match the string Colour as well as Color so that 
we could check for British spellings, we would 
use the following: 

► Multiple character wildcard: An asterisk (*) 

► Single character wildcard: A question mark (?) 

► Input match string: Col o*r 

► Candidate match string: Either Col or or 

Col our 

The result of this should be a positive match. To 
do this, we built a class that contained member 
variables for the match characters and strings, 
and routines to access those match elements. In 



addition, the class contains a single method, 
called matches, which indicates if the input and 
candidate strings match. 

3. Save the source code in the code editor. 

Testing the Wildcard 
Matching Class 

After you create a class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 

The following steps show you how to create a test 
driver to illustrate various kinds of input from the 
user, and show how the class is intended to be used. 

f. In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch6_12 . cpp. 
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2. Type the code from Listing 55-2 into your file. 

Better yet, copy the code from the source file on 
jn Web site. 
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if ( m . matches ( ) ) 

pri ntf ( "match\n" ) ; 

el se 

pri ntf ( "no match\n" ) ; 



Listing 55-2: The Wildcard Matching Test Driver 

string get_a_line( istream& in ) 

^^^^^^ 

string retStr; 

while ( h'n.faiK) ) 

{ 

char c ; 
i n . get ( c ) ; 
if ( in. fail () ) 
brea k ; 

if ( c != '\r' && c != '\n' ) 

retStr += c; 
if ( c == '\n' ) 

brea k ; 

} 

return retStr; 



int maind'nt argc, char **argv) 

{ 

char szPattern [ 80 ] ; 
char szString [ 80 ] ; 



The test driver simply gets two strings from the 
user and uses wildcard matching to see if they 
match. The pattern string may contain optional 
wildcards, although the string to match may not. 
By utilizing the Match class that we developed in 
Listing 55-1, we check to see if the two strings are 
wildcard matches of each other. 

3, Save the source code in the editor and close 
the editor application. 

4. Compile the application, using your favorite 
compiler on your favorite operating system. 

$ m Run the application on your favorite operating 
system. 

If you have done everything right, you should see 
the following session on your console window: 



bool done = 


fal se ; 


$ ./a.exe 










Enter the 


pattern 


: A*B 






Enter the 


string: 


AB 


while ( Idone ) 


match 




1 




Enter the 


pattern 


: A*B 


cout << 


" Enter the pattern : " ; 


Enter the 


string: 


AajkjB 


string sPattern = get_a_line( cin ); 


match 






if ( !sPattern.length( ) ) 


Enter the 


pattern 


: A*B 


done = true; 


Enter the 


string: 


ABC 


el se 




no match 






{ 




Enter the 


pattern 


: A?B 


cout << "Enter the string: "; 


Enter the 


string: 


AbaB 


string sString = get_a_line( cin 


no match 




); 




Enter the 


pattern : 





Match m(sPattern.c_str( ) 
sStri ng . c_str ( ) ) ; 



As you can see, the matching class works as 
advertised. 



Part VIII 
DropBooks I|JL .,. JL . 

Utilities 



The 5 th Wave By Rich Tennant 




" I couldn't get this 'job skills' program to 
vrorK on my ?C, so I replaced the mother- 
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The World Wide Web has brought with it a host of new opportunities 
and a host of new problems. Most applications these days need to 
be Web-enabled to work directly with Web browsers or Web appli- 
cations. No matter what kind of application you're developing, odds are 
that the application will have to interact with the Web or with remote 
systems that use Web protocols. 

The biggest issue in interfacing with the Internet is that of encoding. 
Encoding is the process of translating characters that cannot be directly 
used by a system into characters that can. For the World Wide Web, for 
example, characters such as the ampersand (&), greater- and less- than 
signs (> and <), and others cannot be directly used. We need to change 
them into a form that the Web can use. The Web identifies addresses with 
a Uniform Resource Locator, better known as a URL. One of the rules of 
working with URLs is that they cannot contain characters such as spaces 
and slashes, because including them would break many existing browser 
applications and operating systems. Browsers assume that spaces and 
slashes indicate breaks in a URL, which is the standard format for Web 
addresses. There is no way to change the browser, so we must change 
the string. 

The problem is that the C++ library offers no standard way to encode and 
decode URL strings. The technique for encoding and decoding is well 
known, but it is new enough that it has not yet made it into the STL or 
standard C++ library. For this reason, we end up reimplementing the code 
in each and every application that we write that needs the functionality. 
This is contrary to the C++ principle of "write once, reuse many times." 

Saving time is often about anticipating the needs of your application and 
planning for them in advance. By planning to Web-enable your code — 
regardless of whether you expect your application to support the Web 
(initially, at least) — you save a lot of time in the long-run. It makes 
sense, then, to create a single, reusable class that will do the encoding 
and decoding work, one you can insert as needed in the applications you 
develop. That's what this technique is all about. 
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Creating the URL Codec Class 



;odec" is a compressor/ 
sed for compressing audio 
orMdeo formats into a smaller size. However, the 
concept is very applicable to what we are doing with 
text because we are working with streams of data 
that are similar to video and audio formats. For the 
purposes of this technique, we are going to create a 
simple class that understands how to encode a string 
so that it can be used with existing Web browsers. 
Each character in the string will be examined, and if 
it is not in a valid format for the Web, will be encoded 
to use the proper syntax. Here's how it works: 

In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch56 . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for our 
automation object. 

2. Type the code in Listing 56-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 56-1: Data Encoding and Decoding 

#include <string> 
#i include <iostream> 

using namespace std; 

class URLCodec 
{ 

string _url ; 
protected : 

// Convert a hex string to an ASCII rep- 

resentati on . 
char htoa (int number) 

{ 

if ((number >= 0) && (number <= 9)) 
return ( ' 0 ' + number ) ; 



else if ((number >= 10) && (number 
<= 15)) 

return ('A' + number - 10); 

el se 

return ( ' X ' ) ; 



) 



// Convert an ASCII string into a hex 
digit. 

char atoh (unsigned char character) 
( 

if ((character >= '0') && (character 
<= '9')) 

return (character - '0'); 
else if ((character >= 'A') && 
(character <= ' F' ) ) 

return (character - 'A' + 10); 
else if ((character >= 'a') && 
(character <= ' f ' ) ) 

return (character - 'a' + 10); 

el se 

return ( 0 ) ; 



publ i c : 

URLCodec( void ) 



_url = " " ; 
URLCodec( const char *strln ) 

_url = strln; 
URLCodec( const URLCodecS aCopy ) 
_url = aCopy ._url ; 

URLCodec operator=( const URLCodec& 

aCopy ) 

_url = aCopy ._url ; 
return *this; 

void setURL ( const char *strln ) 

_url = strln; 
void setURL ( const strings sin ) 
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_url 



sin; 



string get URL ( void ) 
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string encodeO -* 
{ 

int index; 
string encoded; 

// Make a copy of the string, 
encoded = _url ; 

// Scan the input string backward, 
index = encoded . 1 ength () ; 
while (index--) 



// Make a copy of the string, 
encoded = _url ; 

// Scan the input string backward, 
index = encoded . 1 ength () ; 
while (index--) 
{ 

// Check for special characters, 
if ( ( ! i sal num( ( unsi gned 
char)encoded[i ndex] ) ) && 

(encoded[index] 

(encoded[index] 

(encoded[index] 

(encoded[index] 

(encoded[index] 

(encoded[index] 

(encoded[index] 

(encoded[index] != 'V')) 



<' ) 
>' ) 
_' ) 
\n' : 
/' ) 



// Check for special characters, 
if ( ! i sal num( ( unsi gned 

char)encoded[index] ) ) -> 2 

{ 

unsigned char special; 
char insert; 

special = (unsigned char) 

encoded[i ndex] ; 
encoded . erase (index, 1); 
insert = htoa (special % 

16) ; 

encoded . i nsert (index, 

&i nsert , 1 ) ; 
insert = htoa (special / 

16) ; 

encoded . i nsert (index, 

&i nsert , 1 ) ; 
i nsert = ' % ' ; 
encoded . i nsert (index, 

&i nsert , 1 ) ; 



unsigned char special; 
char insert; 

special = (unsigned char) 

encoded[i ndex] ; 
encoded . erase (index, 1); 
insert = htoa (special % 

16) ; 

encoded . i nsert (index, 

&i nsert , 1 ) ; 
insert = htoa (special / 

16); 

encoded . i nsert (index, 

& i n s e r t , 1 ) ; 
insert = ' % ' ; 
encoded . i nsert (index, 

&i nsert , 1 ) ; 



return (encoded) ; 



return (encoded) ; 



string encode_no_xml ( ) 

I 

int index; 
string encoded; 



string decodeO 
{ 

int index; 
string decoded; 

// Make a copy of the string, 
decoded = _url ; 



(continued) 
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Listing 56-1 (continued) 



II Scan input string forwards 
i ndex =i 0 ; 

< decoded . 1 ength ( ) ) 



Drop Books 

// fhort 



// Check for encoded characters, 
if (decoded[i ndex] == '%') 

{ 

unsigned char special; 



If you are working with standard URLs for the 
Web, use the first version. If you are working 
with Java applets or .Net applications running on 
the Web that are expecting valid XML characters, 
use the second. In any case, you may use the 
decode method, shown at -* 4, to decode the 
characters into a human-readable string. 

3. Save the source code in the code editor. 



special = (unsigned char) 
atoh(decoded[index+l] ) * 

16; 

special += (unsigned char) 
at oh ( decoded [index+2] ) ; 

decoded . erase (index, 3); 

decoded . i nsert (index, (char 
*)&special , 1) ; 



i ndex++; 



return (decoded) ; 



Testing the URL Codec Class 

After you create a class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 

The following steps show you how to create a test 
driver that illustrates various kinds of input from the 
user, and shows how the class is intended to be 
used. 



This class will handle the encoding and decoding 
of URLs, as well as storing a generic URL string. 
Each character in the string is examined, starting 
at the rear of the string and working backwards, 
so that we can properly interpret characters as 
we need to. 

There are two forms of the encode method 
shown here: 

► The first, shown at the line marked -> 1 , 
encodes all characters for the string in stan- 
dard URL format. This is done at the loop, 
shown by the line marked -* 2. Each charac- 
ter is checked to see if it is in the valid 
alphanumeric order, and if not, it is replaced 
by its hex equivalent. 

► The second, shown at the line marked with 
-> 3, does the same thing, but does not 
encode XML characters that some applica- 
tions for the Web will need. 



f. In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch56 . cpp. 

2. Type the code from Listing 56-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 56-2: The URL Codec Test Driver 

int maind'nt argc, char **argv) 
1 

if ( argc < 2 ) 

{ 

cout << "Usage: ch7_l urll [url2 

url3]" << endl ; 
cout << "Where: url[n] is the url 

you wish to see encoded/decoded" 

<< endl ; 
return -1; 

} 
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for ( int i=lj i<argc; ++i ) 

{ 

URLCodec url ( argv[i] ); 
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string dec 



decoding it. 
url . encode( ) ; 
url .decode( ) ; 



<< argv[i] 



cout << "Input String: 

<< endl ; 

cout << "Encoded: " << enc.c_str() 

<< endl ; 

cout << "Decoded: " << dec.c_str() 

<< endl ; 



3. Save the source-code file in the editor and close 
the editor application. 

4. Compile the source file with your favorite com- 
piler, on your favorite operating system. 

5. Run the application on your favorite operating 
system. 

If you have done everything right, you can produce a 
session similar to the one shown in Listing 56-3 on 
your console window. 



// Now try decoding the result. 
URLCodec enc_url ( enc.c_str() ); 
string end = url . encodet ) ; 
string decl = url .decodet ) ; 
cout << "Input String: " << 

enc_url . getURK ) . c_str( ) << endl; 
cout << "Encoded: " << encl.c_str() 

<< endl ; 

cout << "Decoded: " << decl.c_str() 
<< endl ; 

} 

return 0; 



The test driver code above simply allows you to 
test out the functionality of the encode and 
decode methods of the URLCodec class. If you 
enter a string from the command line to the 
application, it will print out the encoded and 
decoded versions of the string. There is nothing 
really magical about this application. As you can 
see from the listing, the code first tries to encode 
the string you give it (shown at -» 5) and then 
decodes the result of that encoding to see if they 
are the same. The second block of code then 
encodes the result and decodes it to ensure that 
the code is working properly. When all is said 
and done, you should see the same input and 
output to the console. 



Listing 56-3: Output from the Test Driver 

$ ./a.exe "http://this is a bad url" 

"http://localhost/c:/x*.xml" 
Input String: http://this is a bad url 
Encoded: http%3A%2F%2Fthi s%20i s% 

20a%20bad%20url 
Decoded: http://this is a bad url 
Input String: http%3A%2F%2Fthi s%20i s%20a% 

20bad%20url 
Encoded: http%3A%2F%2Fthi s%20i s%20 

a%20bad%20url 
Decoded: http://this is a bad url 
Input String: http : //I ocal host/c : /x* . xml 
Encoded: http%3A%2F%2Fl ocal host%2Fc%3A% 

2Fx%2A%2Exml 
Decoded: http://localhost/c:/x*.xml 
Input String: http%3A%2F%2Fl ocal host%2Fc%3A% 

2Fx%2A%2Exml 
Encoded: http%3A%2F%2Fl ocal host%2Fc%3A% 

2Fx%2A%2Exml 
Decoded: http://localhost/c:/x*.xml 



Note that input strings on the command line must be 
enclosed in quotes; otherwise, they will be parsed 
into separate words on the space breaks. 

As you can see, the input is properly converted into 
the encoded version of the URL string that can be 
used by Web browsers or servers. The decoded ver- 
sion is what you would expect it to be, in a form that 
can be used by any application. 
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Whenever you are exchanging data with a 
Web-based application, encode the data you 
send; expect the data you get back to be 
eJco>ted^fei|itJ-ia«^pplication, too. Prepare 

[f^rajf h encoding and decoding 
this information. Ifit turns out that the data 



does not need to be encoded or decoded, you 
will have wasted a small amount of time. But if 
the data does need encoding/decoding, you 
will have saved a lot of time that would other- 
wise be spent figuring out why your data 
looks strange and breaks things. 
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It would be very nice if we could all trust everyone around us not to 
view or access our private information. Unfortunately, not everyone is 
quite as trustworthy as you or I. The fact of the matter is that sensitive 
information, such as passwords, user names, and credit card numbers, 
simply should not be stored in a readily readable fashion. If we fail to 
hide the information in some way, we can be very sure that the informa- 
tion will find its way to every cracker on the Internet and be used in all 
sorts of evil and insidious ways. Hiding information is a task normally 
accomplished by encryption — translating data from a human-readable 
format to a non-human-readable format. There are almost as many ways 
to encrypt data as there are to create it in the first place. Serious encryp- 
tion methods, such as the RSS or Blowfish encryption algorithms are 
very complex; they would take pages and pages to explain (and in the 
end, they'd still be about as hard to understand). 



This technique looks at two very simple — but effective — methods of 
encrypting data from prying eyes: the Rot 13 algorithm and the XOR algo- 
rithm (XOR stands for "Exclusive Or"). Both methods can defeat casual 
snoopers, but they're not foolproof; I wouldn't recommend using either 
method for industrial-strength applications. It is difficult, if not impossi- 
ble, to add encryption to an application after it's been written. In order to 
make a secure system, encryption should be included as early in the 
process as possible. By adding these algorithms at the design phase, you 
will save time and effort and create a more secure system. 



/^WN Selecting an encryption method is almost as sensitive an issue as 
L. I «aj selecting a programmer's editor or compiler. You can save a lot of 
time by selecting a standard algorithm that provides the level of 
security your system needs. If you are writing a simple in-house 
application, XOR encryption is probably more than secure enough. 
On the other hand, if you are writing a medical-storage application 
(that is, one that allows access to a database of patient information) 
that allows access via the Internet, choose a much stronger method, 
such as the Blowfish algorithm. 
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Implementing the Rot13 
Atamthm 




<oti3 aTgoritnm is really a very simple way of 
encoding data that makes that data difficult to read, 
but is almost trivial to decode. The algorithm, as the 
name suggests, simply rotates characters 13 places 
in the alphabet. Therefore, an A becomes an N and 
so forth. The algorithm wraps around, so anything 
past Z goes back to A. The following steps show 
you how to create a simple class that can both 
encode and decode Rotl3 strings. This class is cer- 
tainly not industrial-strength encryption, but it will 
make it difficult for the average person to read your 
strings. 

f. In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch57 . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for your 
automation object. 

2. Type the code from Listing 57-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 57-1: The Rot13 Algorithm Code 

#i include <string> 
#i include <iostream> 

using namespace std; 

class Rotl3Encrypti on 
{ 

pri vate : 

string _encrypt; 
protected : 

string rotl3(const string& strln) 

{ 

stri ng sOut = " " ; 



for ( int i=0; i<(int)strln.size( ) ; 
++i ) 

{ 

char ch = s t r I n [ i ] ; 
// the following assumes that 
' a ' + 25 == ' z ' and 



' Z ' , etc . 

1& ch <= 
ch <= '2 



'A' + 25 == 
if( (ch >= 'N' 
(ch >= 'n' 8 
ch -= 13; 
else if( (ch >= 'A' && ch <= 
'M' ) || (ch >= 'a' && ch <= 
■nT) ) 
ch += 13; 
sOut += ch; 



return sOut; 

} 

publ i c : 

Rotl3Encryption(void) 

1 

} 

Rotl3Encrypti on ( const char *strln ) 
( 

if ( strln ) 
{ 

_encrypt = rotl3( strln ); 

I 

} 

Rotl3Encryption( const Rotl3Encrypti on& 

aCopy ) 

1 

_encrypt = aCopy._encrypt; 

} 

Rotl3Encrypti on operator=( const 
Rotl3Encrypti on& aCopy ) 

1 

_encrypt = aCopy._encrypt; 
return *this; 

} 

string operator=( const char *strln ) 

{ 

if ( strln ) 

{ 

_encrypt = rotl3( strln ); 

} 

return _encrypt; 

} 

const char *operator<<( const char 
*strln ) 
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if ( s t r I n ) 

{ 

encrypt = rotl3( strln ); 
pt . c_str ( ) ; 
string Stri ng ( voi d ) const 
return _encrypt; 



_encrypt 

Dropr360k& 



}; 



ostream& operator<<( ostream& out, const 
Rotl3Encrypti on& rl3 ) 

{ 

out << rl3 . Stri ng ( ) . c_str ( ) ; 
return out; 



The code in the above listing implements a sim- 
ple Rot 13 algorithm. The bulk of the work is done 
in the Rotl3 function, which simply rotates char- 
acters 13 positions in the alphabet. If you look at 
the code at -> 1, you can see how this works. As 
the comment in this function specifies, it 
assumes that the alphabet is contiguous for the 
character set you are working with. This means 
that this code will not work on older EBCDIC sys- 
tems, nor will it work with non-English character 
sets. Unfortunately, this is true of most text- 
based encryption algorithms. The other methods 
of the class, such as the operator << method, 
are utility functions that can be used to convert 
the encrypted string for output, or to stream it to 
an output file. 

3, Save the source file in your text editor. 

This class will handle the Rot 13 algorithm. This 
algorithm works by simply rotating data about in 
the alphabet. The string is then unreadable by 
humans, which is the entire point of encryption. 



Testing the Roi\3 Algorithm 

After you create a class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 

The following list shows you how to create a test 
driver that illustrates various kinds of input from the 
user, and shows how the class is intended to be 
used. 

In the code editor of your choice, reopen 



the source file to hold the i 


:ode for your test 


program. 




In this example, I named the test program 


ch57 . cpp. 




2, Type the code from Listing 


57-2 into your file. 


Better yet, copy the code from the source file on 


this book's companion Web 


site. 


Listing 57-2: Testing the Rot13 Encryption Class 


int maint int argc, char * 


*argv ) 


{ 

Rotl3Encrypti on rl3("T 


hi s is s test" ) ; 


cout << rl3 . Stri ng ( ) . c 


_str( ) << endl ; 


cout << 




Rotl3Encryption(rl3. 


Stri ng( ) . c_str( ) ) 


<< endl ; 





return 0; 



3, Compile the source file, using your favorite 
compiler on your favorite operating system. 

4. Run the application in the console. 

If you have done everything properly, you should 
see the following output on the console window: 



Guvf vf n grfg 
This is a test 
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The first output (shown at -* 2) is the rotated ver- 
sion of the string. It remains human-readable, at 
least u»** a point, because the substituted charac- 
^JpMTfRrfnjp^lliu^l©), but it certainly provides 
To|cTOeTmrn^eVrfarttftVcntent of the text it is 
encrypting. Thus the purpose of encryption is 
preserved. 



Encryption is intended to hide the purpose of 
the text from the user, not to make the text 
vanish or compress. Note that the string used 
is embedded in the application; this particular 
program does not accept any input from the 
user. It is a very simple test driver. 



Unfortunately, Rot 13 is one of the most common 
algorithms in use; hackers know it like the backs of 
their hands. We need a slightly better approach. 



Implementing the 
XOR Algorithm 



The next encryption algorithm we examine is the 
XOR algorithm. XOR stands for Exclusive OR, which 
means that it uses the mathematical "exclusive or" 
operator in order to convert text. One property of 
the exclusive o r operation is that a character that is 
exclusively or'd with another character can be 
returned to its original state by or'ing it again with 
the same character. This means that an encryption 
password can be used to both encode and decode a 
string using XOR. In this technique, we build a simple 
class that implements the XOR algorithm and pro- 
vides methods for encoding and decoding strings. 

/. In the code editor of your choice, reopen the 
source file to hold the code for the source file 
of the technique. 

In this example, the file is named ch57 . cpp, 
although you can use whatever you choose. 



2. Append the code from Listing 57-3 into your 
file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 57-3: The XOREncryption Class 

class XOREncryption 
{ 

pri vate : 

char *_encrypt; 

int _length; 

string _key; 
protected : 

char *do_xor( const char *sln, int 

length, const string& key) -> 3 

( 

int idx = 0; 

char *str0ut = new char[ length ]; 

if ( ! key . 1 ength( ) ) 
return strOut; 

for ( int i=0; i<length; ++i ) 
1 

char c = ( s I n [ i ] A key[idx]); 
str0ut[i ] = c ; 

idx ++; 

if ( idx >= key. length () ) 
idx = 0; 

) 

return strOut; 

} 

publ i c : 

XOREncryption(void) 
1 

_encrypt = NULL; 

I 

XOREncrypti on ( const char *strln, int 
length, const char *keyln ) 

{ 

if ( key In ) 

_key = keyln; 
if ( strln ) 

{ 

_length = length; 
_encrypt = do_xor( strln, 
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1 ength , _key ) ; 



Drop^MkS 



onst XOREncrypti on& 
encrypt = new char [ aCopy ._1 ength 



]; 



memcpy ( _encrypt, aCopy ._encrypt , 

aCopy ._] ength ) ; 
_key = aCopy._key; 

_length = aCopy ._1 ength ; 

} 

XOREncrypti on operator=( const 
XOREncrypti on& aCopy ) 

{ 

_encrypt = new char [ aCopy ._! ength 
]; 

memcpy ( _encrypt, aCopy ._encrypt , 

aCopy ._! ength ) ; 
_key = aCopy._key; 

_length = aCopy ._! ength ; 
return *this; 

} 

-XOREncrypti on ( voi d ) 

{ 

delete _encrypt; 

} 

const char *operator=( const char *strln 



if ( _encrypt ) 

delete _encrypt; 

if ( s t r I n ) 
{ 

_encrypt = do_xor( strln, 
strl en ( str In ) , _key ) ; 

) 

return _encrypt; 

} 

const char *operator<<( const char 
*strln ) 

{ 

if ( strln ) 
{ 

_encrypt = do_xor( strln, 
strl en ( str In ) , _key ) ; 



return _encrypt; 

} 

const char *Stri ng ( voi d ) const 
{ 

return _encrypt; 

} 

int Length(void) const 
{ 

return _length; 



The code in this class implements a simple XOR 
algorithm. The main functionality of the class is 
shown in the do_xor method, shown at -> 3. As 
you can see, the method takes the input encryp- 
tion key and XORs it with the string that is pro- 
vided by the user. The class requires two strings, 
one that is a "key" used for encrypting or 
decrypting strings. The second string is the 
input string to be encrypted or decrypted. 
Running the algorithm with the same inputs 
twice results in the original string. 

3. Save the source file in your text editor. 

Testing the XOR Algorithm 

The following steps show you how to create a test 
driver that illustrates various kinds of input from the 
user, and show how the class is intended to be used: 

f m In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch57 . cpp. 

2. Type the code from Listing 57-4 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 
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Listing 57-4: Testing the XOREncryption Class 

int main( int argc, char **argv ) 
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13( "Thi s is s test" ) ; 
g( ) . c_str( ) << endl ; 



cout << 

Rotl3Encryption(rl3.String() .c_str( ) ) 
<< endl ; 

XOREncryption xlC'This is a test", 
strlenC'This is a test"), "C++Test"); 

cout << xl.StringO << endl; 

XOREncryption x2 (xl . Stri ng ( ) , 

xl.LengthO, "C++Test"); 4 

cout << x2.String() << endl; 

return 0; 



3. Compile the source file, using your favorite 
compiler on your favorite operating system. 

4. Run the application in the console. 

If you have done everything properly, you should 
see the following output on the console window: 

$ ./a.exe 
Guvf vf n grfg 
This is a test 

_CB'E_cJ_ ->5 
This is a test -> 6 



Note that the above output includes the Rot 13 
encryption that we developed earlier in this tech- 
nique for comparison. The strings are all hard-coded 
into the application, and your output might vary 
depending on the font and terminal type you are 
using. The output for the XOREncryption class is 
shown at -* 5 and -* 6. Our original string is Thi s is 
a test and the two lines following it show how that 
line is first encrypted and then decrypted using the 
same key. In this case, our "key" is the string 
C++Test. 

/^~3bs The XOREncrypti on class does not use a 
f j^k^ J string to hold the encrypted version of the 
N^^y input (see -* 4 in Listing 57-4), nor does it 
return the value as a string object. This is 
because the string class holds only alpha- 
numeric data. The xor operation can result 
in non-alphanumeric values, and at times can 
cause the string class to return only a por- 
tion of the original string. 



Never use a string object to store character 
buffers that might contain nulls or control 
characters. String classes assume that the null 
character terminates the string and will not 
store any characters past the null. 
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In the good old days of C programming, converting the case of a string 
was a simple matter. You just called the strupr function and the string 
was instantly converted to uppercase. Similarly, if you called the 
st rl wr function, the string was converted to lowercase. Have things 
really changed all that much since then? Well, in some ways, things have 
changed a lot. For example, the following code is not permissible: 

string myString = "Hello world" 
strupr( myStri ng ) ; 

This code will not compile, since the strupr function does not accept a 
string argument. Nor can you write the following code and expect it to 
work: 



strupr(myString.c_str( ) ) ; 



This code will not compile either; the strupr function cannot accept a 
const character pointer — which is what the c_str method returns. So 
how do you write code to convert modern string objects to upper- and 
lowercase? You could use the brute-force technique, like this: 

for ( int i=0; i <mySt ri ng . 1 engt h ( ) ; ++i ) 
myString[i] = toupper(myStri ng[i ] ) ; 

This code certainly does work, but it is not very elegant and it does not 
anticipate all circumstances. It assumes, for example, that the string 
characters are in contiguous order in memory — which is a bad assump- 
tion to make about any Standard Template Library (STL) collection. The 
entire purpose of the STL is to provide the developer with a way in which 
to access containers (strings are just containers of characters) without 
any assumptions about how they are organized in memory. The better 
choice, of course, is to use an iterator (see Technique 49 for more on iter- 
ators). However, the STL provides an even better approach to the whole 
thing, which is the transform function found in the algorithms of the STL. 
The transform function allows you to operate in a container-independent 
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way to modify the individual elements of a container 
through a conversion function. This saves time 
becausfi^ie algorithm has already been written, 

I Kr^l^T M S^r^f'' , S r Wf e CJ' t a ' so saves time because 
I V^I^^L^sV^eVb€na\sSr conversion functions 
without rewriting the basic algorithm. 



Always make sure that you are using the most 
efficient code for your application up front. 
Rather than trying to implement your own 
algorithms to work with the Standard 
Template Library, choose to use the ones in 
the <al gori thm> include file as they have 
been optimized for working with the STL 
collections. 



Implementing the transform 
Function to Convert Strings 

The transform algorithm of the Standard Template 
Library uses a function created by the user of the 
algorithm to convert each element of a container in 
some way. The following steps show you how to cre- 
ate a simple transform function to convert the case 
of a string, to either upper- or lowercase. By looking 
at the technique and how the code is implemented, 
you will be able to see how to extend the functional- 
ity for your own uses in the future. In order to imple- 
ment this function, we will need to implement a class 
which does the work of our transformation. The 
transform algorithm accepts two iterators and an 
object to do its work. Let's take a look at exactly how 
this is implemented in your own code. 

f m In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch58 . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for your 
automation object. 



2. Type the code from Listing 58-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 58-1: Conversion Code for the STL String Class 

//include <string> 
#include <algorithm> 
#include <iostream> 
#include <vector> 
^include <ctype.h> 

using namespace std; 

// A function for converting a string to 
// lowercase. 

string convert_to_l owercase( const strings 

sin ) 

( 

// First, save a pointer to the 
f uncti on . 
int (*pf ) ( i nt )=tol ower ; 

// Next, convert the string, 
string sOut = sin; 
trans form(sOut. beg in( ) , sOut.end( ) , 
sOut.begint ) , pf ) ; 

return sOut; 



// A function for converting a string to 
// uppercase. 

string convert_to_uppercase( const string 

sin ) 

1 

// First, save a pointer to the 
f uncti on . 
int (*pf ) ( i nt )=toupper ; 

// Next, convert the string, 
string sOut = sin; 
trans form (sOut.begint ) , sOut.end( ) , 
sOut.begin( ) , pf ) ; 

return sOut; 
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string stri p_l eadi ng ( const string& sin ) 




Si. 



// Find the first non-white-space 
ariftlr^ 

iT? nTPBs^^^In . 1 ength ( ) && isspace 
( sIn[iPos] ) ) 

iPos ++; 
// Copy the rest of it. 
string sOut; 

for ( int i=iPos; i <s In . 1 ength ( ) ; ++i ) 
sOut += sln[i ] ; 

return sOut; 



string stri p_trai 1 i ng ( const string& sin ) 

{ 

// Find the last non-white-space 

character . 
int iPos = s In . 1 ength ()- 1 ; 
while ( iPos >= 0 && isspacet sIn[iPos] 
) ) 

iPos --; 
// Copy the rest of it. 
string sOut; 

for ( int i=0; i <=i Pos ; ++i ) 
sOut += sln[i ] ; 



publ i c : 

string operatort ) (string s) 
{ 

return stri p_l eadi ng( stri p_ 
t r a i 1 i n g ( s ) ) ; 



This code implements all of the various possible 
transforms for the string class, and throws in sev- 
eral bonus methods for manipulating the strings 
(such as stripping the leading and trailing charac- 
ters). In all cases, we will use the transform method 
to actually modify the strings or arrays. As the test 
driver in this technique illustrates, a single string is 
no more difficult to convert than is an entire string 
array. The important functionality here is the class 
we will be using to convert strings to lowercase, 
which is the Stri ngConvertToLowerCase class shown 
at -» 1. The transform function uses this class to 
convert strings. As you can see, all of the work is 
done in a single method, the operatorO method. 
This method is called by the transform algorithm to 
do its work, as we will see shortly. 



return sOut; 

} 

// This is a utility class that will convert 
// a string to lowercase. 

class Stri ngConvertToLowerCase -* 1 

{ 

public: 

string operator ()( stri ng s) 

{ 

return convert_to_l ower_case( s ) ; 

I 

}; 

// This is a utility class that will strip 
// leading AND trailing white space, 
class Stri ngStri pSpace 

{ 



Testing the String Conversions 

After you create a class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 

The following list shows you how to create a test 
driver that illustrates various kinds of input from the 
user, and shows how the class is intended to be 
used. 

In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch58 . cpp. 
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2. Type the code from Listing 58-2 into your file. 

Better yet, copy the code from the source file on 
iisJba«k's>^iliiiaBion Web site. 




int maind'nt argc, char **argv) 

{ 

vectoKstri ng> stringArray; 
if ( argc < 2 ) 

{ 

cout << "Usage: ch7_3 stringl 
[string2 string3...]" << endl ; 

cout << "Where: string[n] is the 
string to convert" << endl; 

return -1; 



// First, do them individually, 
cout << "Individual Conversions: 
endl ; 

for ( int i=l; i<argc; ++i ) 



" << 



cout << "Input String: " << argv[i] 

<< endl ; 
string sLower = 

convert_to_l ower_case( argv[i] ); 
cout << "Lowercase String: " << 

sLower . c_str( ) << endl; 
string slipper = 

convert_to_upper_case( argv[i] ); 
cout << "Uppercase String: " << 

sUpper . c_str( ) << endl; 
stri ngArray . i nsert( 

stringArray .end( ) , argv[i] ); -* ' 




vector<string>: : iterator iter; 
for ( iter = stri ngArray . begi n () ; iter 
!= stri ngArray . end () ; ++iter ) 
cout << "String: " << 
(*iter) .c_str( ) << endl; 

cout << endl << "Individual String 
Whitespace Strip fest: " << endl; 
string whiteSpace = " This is a test 

string sNoWhite = stri p_l eadi ng( 

whi teSpace ) ; 
cout << "Stripped String: [" << 

sNoWhite.c_str( ) << "]" << endl; 
sNoWhite = stri p_trai 1 i ng( whiteSpace ); 
cout << "Stripped String: [" << 

sNoWhite.c_str( ) << "]" << endl; 

trans form (stri ngArray. beg int), 
stri ngArray . end ( ) , 
stri ngArray . begi n ( ) , 
Stri ngStri pSpace( ) ) ; 
cout << endl << "Array of Strings 

Whitespace Strip Test: " << endl; 
for ( iter = stri ngArray . begi n () ; iter 
!= stri ngArray . end () ; ++iter ) 
cout << "String: [" << 

(*iter) .c_str( ) << "]" << endl; 

return 0; 



// Now do the whole array, 
transf orm( stri ngArray . begi n ( ) , 

stri ngArray . end ( ) , 

stringArray .begint ) , 

Stri ngConvertToLowerCaset ) ); 

// Print them out. 
cout << endl << "Array Conversions: 
endl ; 



3, Save the source code in your code editor and 
_^ 4 close the editor application. 

4, Compile the source code with your favorite 
compiler, on your favorite operating system. 

5, Run the program on your favorite operating 
system. 

If you have done everything right, you should see 
the output shown in Listing 58-3 in the console 
" << window. 



Testing the String Conversions 



Listing 58-3: Output from the String Conversion Test 

$ ./a.exe " This is a test" "This is 



l*M>ther test 

DrODDOOKS 

I nworraco ^ 1- i n n • 



Final Test 

»ns : 

is is a test 
this is a test 



Lowercase String: 
Uppercase String: THIS IS A TEST 
Input String: This is another test 
Lowercase String: this is another test 
Uppercase String: THIS IS ANOTHER TEST 
Input String: Final Test 
Lowercase String: final test 
Uppercase String: FINAL TEST 

Array Conversions: 
String: this is a test 
String: this is another test 
String: final test 

Individual String Whitespace Strip Test: 
Stripped String: [This is a test ] 
Stripped String: [ This is a test] 



The first line of the output is simply the executable 
name and the arguments to the program (shown 

2 at -»■ 2). As you can see, we are passing in three 

3 arguments. The various transformations are then 
run on each of these arguments. First, we use the 
individual utility functions (as shown at -+ 3) to 
convert each of the input strings. This simply shows 
that the functions are working properly The strings 
are then added to an array (shown at -> 4 in Listing 
58-2). The transform functions are then applied, con- 
verting each string to lowercase (shown in the output 
at -* 5). Finally, just to show how the transformation 
can be applied to any string, we use the white space 

g removal functions to change the strings to have no 
leading or trailing white space. 



T 
v 



Keep a library of utility classes around for all of 
your projects and you will find that you use 
them automatically — saving time and energy 
in solving little problems. 



Array of Strings Whitespace Strip Test: 
String: [this is a test] 
String: [this is another test] 
String: [final test] 
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tion interface 

Testing the interface 



Implementing interfaces can save you loads of time when you are doing 
the same thing over and over in your application, or even across appli- 
cations. In addition, it collects all of the code for a given task in one 
place, making it quick and easy to change the format of output files or 
the algorithm used for the functionality of the interface. 

If you have ever used Java as a programming language, you're probably 
already accustomed to interfaces. Simply put, an interface is a base class 
from which you can inherit that provides a given service. The C++ lan- 
guage supports interfaces, although they are slightly different in terms of 
syntax. Unlike a typical base class, interfaces are less concrete and do 
not generally allow the application to build upon them, but rather to use 
them to provide a specific service. In C++, an interface is a pure virtual 
base class that contains multiple pure virtual methods. A pure virtual 
method, unlike a regular virtual method, must be overridden by a 
derived class. For example, an interface might allow your class to print 
itself out, or save itself to a file, or even allocate its memory from some 
specialized form of hardware space. This technique shows how to imple- 
ment an important concept — serialization — as an interface. The most 
important thing about interfaces, and the way in which they will save you 
the majority of time, is that if you inherit from an interface, you can pass 
your object to any function or method that works with objects that 
implement that interface. So, if you have a function that is used to save 
all sorts of objects, you can pass your object to the function so long as it 
implements the Save interface. 

Essentially, serialization is the capability of an object to write itself to 
some form of persistent storage. The code that does the job tends to be 
the same from class to class; the data being written is what changes. 
Accordingly, serialization lends itself perfectly to the process of creating 
an interface. 



There are two basic steps to implementing an interface in your class: 
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You must create the actual interface class and 
identify all areas in which you need input from 
derived class. At this stage, you're imple- 
,a*^UTE>u*Otionality for the interface 
'c\eiftFKiw^ if it were a main class for 
your application. 




After you've created the interface class, you set 
up your derived class to inherit from it (and to 
implement any virtual functions the interface 
requires). 



#i include <iostream> 
#1nclude <fstream> 

using namespace std; 

class Seri al i zeEntry 
{ 

string _name; 
string _value; 
publ i c : 

Serial i zeEntry (void) 



Implementing the Serialization 
Interface 

The most popular interface is the serialization 
interface. This interface, used by many of the popu- 
lar class libraries, such as MFC, allows an object to 
be written to persistent storage (such as a file) so 
long as it implements a consistent interface. In this 
example, we will explore how to create a serializa- 
tion interface and apply that interface to a given 
class or classes. 

f m In the code editor of your choice, create a new 
file to hold the code for the interface definition 
of the technique. 

In this example, the file is named ch59 . h, 
although you can use whatever you choose. This 
file will contain the class definition for your seri- 
alization object. 

2. Type the code from Listing 59-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 59-1: The Serialization Interface Code 



Seri al i zeEntry ( const char *name, const 
char *value ) 

{ 

setName( name ) ; 
setVal ue( val ue ) ; 

I 

Seri al i zeEntry ( const char *name, int 
iValue ) 

{ 

setName( name ) ; 
setValuet i Value ); 

I 

Seri al i zeEntry ( const char *name, double 
dValue ) 

{ 

setName( name ) ; 
setVal ue( dVal ue ) ; 



Seri al i zeEntry ( const Seri al i zeEntry& 

aCopy ) 

{ 

setNamet aCopy . getName ( ) . c_str ( ) ); 
setVal ue( aCopy.getValuet). c_str ( ) 



Seri al i zeEntry operator=( const 
Seri al i zeEntry& aCopy) 

{ 

setNamet aCopy .getNamet ) .c_str( ) ): 
setValuet aCopy. getVal ue( ) . c_str ( ) 



) ; 



#ifndef 
#def i ne 



_SERIALIZE_H_ 
SERIALIZE H 



return *this; 



^include <string> 
#include <vector> 



(continued) 
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Listing 59-1 (continued) 



void setNamet const char *name ) 
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_name = ; 

} 

void setValue( const char *value ) 

{ 

if ( value ) 

_val ue = val ue ; 

el se 

_val ue = " " ; 

} 

void setValue( int iValue ) 

{ 

char szBuffer[ 20 ] ; 

spri ntf ( szBuf f er , "M", iValue ); 

setVal ue ( szBuffer ) ; 

} 

void setValue( double dValue ) 

{ 

char szBuffer[ 20 ] ; 

spri ntf ( szBuffer , "%lf", dValue ); 

setVal ue ( szBuffer ) ; 

} 

string getName(void) const 

{ 

return _name; 

) 

string getVal ue(void) const 
{ 

return _val ue ; 



}; 



class Serialization 
{ 

pri vate : 

long _ma jorVersi on ; 

long _mi norVersi on ; 
protected : 

virtual bool getEntriest vector< 
Seri al i zeEntry >& entries ) 

{ 

return true; 

} 

virtual string getCl assName( ) 



return "None"; 



publ i c : 

Seri al i zati on ( voi d ) 

{ 

_majorVersi on = 0; 
_mi norVersi on = 0; 

} 

Serial ization( long major, 

1 ong minor) -* 2 

1 

_ma jorVersi on = major; 
_mi norVersi on = minor; 

} 

Serial ization( const Serializations 
aCopy ) 

{ 

_majorVersi on = aCopy ._majorVersi on ; 
_mi norVersi on = aCopy ._mi norVersi on ; 

} 

Serialization operator=( const 
Serializations aCopy ) 

( 

_majorVersi on = aCopy ._majorVersi on ; 
_mi norVersi on = aCopy ._mi norVersi on ; 
return *this; 



// Accessors 

void setMajorVersion( long major ) 
1 

_majorVersi on = major; 

} 

long getMajorVersion( void ) 
1 

return _majorVersi on ; 

} 

void setMi norVersi on ( long minor ) 
1 

_mi norVersi on = minor; 

} 

long getMi norVersi on ( void ) 

{ 

return _mi norVersi on ; 



// Functionality 

bool writet const char *strFileName ) -* 1 
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II Note the call to the virtual 

method. This must 
// be overridden in the derived 
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ti on . 



alizeEntry > entries; 
getEntries( entries ); -* 3 

if ( entri es . si ze( ) == 0 ) 
return false; 

// Try opening the output file, 
ofstream out( strFileName, 

of stream: : out | of stream: : app ); 
if ( out. fail () ) 
return false; 

// Write out the class name, 
out << "<" << getCl assName( ) << ">" 
<< endl ; 

// Write out the version informa- 

out << "\t<VERSI0N>" << 
_majorVersi on << ":" << 
_minorVersion << " < / V ERS I ON > " << 
endl ; 

vector< Seri al i zeEntry >::iterator 
iter; 

for ( iter = entri es . begi n () ; iter 
!= entri es . end( ) ; ++iter ) 

{ 

out << "\t<" << 

(*iter) .getName( ) .c_str( ) << 

">" << endl ; 
out << "\t\t" << 

(*iter) .getVal ue( ) .c_str( ) << 

endl ; 
out << "\t</" << 

(*iter) .getName( ) .c_str( ) << 

">" << endl ; 



out << "</" << getCl assName( ) << ">" 
<< endl ; 



3. 



This code saves a given class to an output 
stream in standard XML format. It would be sim- 
ple enough, of course, to modify the class to out- 
put in some other format, but for simplicity we 
will use XML. The important member of the class 
is the write method, shown at -» 1. This method 
writes out the members of a class in XML format, 
using the member variables of the class to deter- 
mine the output file and version information. 
Note that the class keeps track of its own version 
information so that you can use it to determine 
whether a persistent version of the class is of the 
proper version for your application. The version 
information is defined in the constructor, as 
shown at -* 2. 

Take a look at the wri te method; it appears that 
the code does everything you would expect a 
seri al i zati on object to do. The important part 
of the function is shown at -»> 3, which is a call 
to a virtual methodcalledgetEntries.This 
method, which must be overridden by any class 
that uses this interface, returns the individual 
member variables of the class as a string array. 
After this method is created for your class, the 
rest of the functionality of the s e r i a 1 i z a t i o n 
interface will work no matter what the content 
of the derived classes. 

Save the source file and close the file in the 
code editor. 



As you can see, the serialization class does most of 
the work by itself. It requires the implementation of 
only two virtual methods: 

V"* The getEl ements method returns all internal ele- 
ments of the class that you want saved. 

The getCl assName method returns the name of 
the class to use as the root of the XML tree that 
receives the element data we write out. 



return true; 



#endif 
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In addition, you can specify major and minor ver- 
sions for the serialized file, so that if you wish to 
import^j^sting serialized files, you will later on be 
TkdlffT^ re^gd by older versions of the 
r eiM«ie\a/ckpl<fp\i^default missing values if 
new ones have been added in the meantime. 





If you are persistently storing data for a class, 
make sure that you store version information 
with the data, so you can always know exactly 
when the data was written and what might be 
missing or superfluous. As classes change over 
time, member variables are added or removed. 
The data stored in a serialized version of older 
classes, therefore, may have additional or miss- 
ing data. If you know what version of the class 
created the serialized data, you will know what 
data to map into your current member vari- 
able set. 



Testing the Serialization 
Interface 

After we have defined the serialization interface, 
the next step is to implement that interface for a real 
class. This allows you to see how the serialization 
process is used and how much time the interface 
concept will save in future class implementations. 
Let's take a look at creating a class with members 
that need to be stored persistently. 

In the code editor, create a new file to hold the 
code for the test class of the technique. 

In this example, the file is named ch59 . cpp, 
although you can use whatever you choose. This 
file will contain the test code for the technique. 

2, Type the code from Listing 59-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 59-2: Testing the Serialization Interface 

#include " seri al i ze . h" 

class MyClass : public Serialization 

{ 

pri vate : 

int _i Value; 

string _sValue; 

double _dValue; 
protected : 

virtual bool getEntries( vector 
< Seri al i zeEntry >& entries ) -* < 

( 

entri es . i nsert ( entri es . end( ) , 
Serial izeEntryt "iValue", 
_iValue ) ); ! 

entri es . i nsert ( entri es . end( ) , 
Serial izeEntryt "sValue", 
_sVal ue . c_str ( ) ) ) ; 

entri es . i nsert ( entri es . end( ) , 

Serial izeEntryt "dValue", _dValue 



virtual string getCl assName( void ) 
( 

return "MyCl ass" ; 

) 

publ i c : 

MyCl ass ( voi d ) 

: Seri al i zati on ( 1 , 0 ) 

f 

_iVal ue = 0; 
_dVal ue = 0.0; 
_sVal ue = " " ; 

} 

MyClassd'nt iVal, double dVal , const 
char *sVal ) 

: Seri al i zati on ( 1 , 0 ) 

1 

_i Value = i Val 
_dValue = dVal 
_sVal ue = sVal 

} 

vi rtual -MyCl ass ( ) 

{ 

Save( ) ; 

} 

virtual void SaveO 



Testing the Serialization Interface 359 



write( "MyCl ass .xml " ) ; 
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MyCl ass ml ( 1 , 2 . 0 , "One" ) ; 



return 0; 



This class simply implements a collection of 
data, with a string value, an integer value, and a 
floating point (double) value. The important 
work takes place in the getEntries virtual func- 
tion, which builds an array of elements to output 
for serialization. This method, shown at -* 4, 
overrides the serialization interface method 
and will be used for output. After this method is 
overridden, the remainder of the code works as 
expected within the interface. Note the use of the 
Seri al i zeEntry class (shown at -» 5) to hold 
the data for each element. Because this class can 
be derived to utilize other data types, the inter- 
face concept works even into the future. 

3. Save the source code as a file in your editor 
and close the editor application. 

4. Compile the source code with your favorite 
compiler on your favorite operating system. 

5. Run the program on your favorite operating 
system. 

If you have done everything right, the program will 
create an output file called MyCl ass .xml in your oper- 
ating system's file system. This file should contain 
the following output after the application is run: 



$ cat MyClass.xml 
<MyCl ass> 

<VERSI0N>1 :0</VERSI0N> 

<iVal ue> 

1 

</iVal ue> 
<sVal ue> 

One 
</sVal ue> 
<dVal ue> 

2.000000 
</dVal ue> 
</MyClass> 

In the output, you can see that all of the data ele- 
ments specified in the MyCl ass class have been out- 
put via the serial ization interface. This shows that 
our code works as we specified. Also note that the 
version information, which we specified in the con- 
structor for the MyCl ass class (shown at -* 6), is out- 
put in the persistent file, so that we can utilize it if 
we add new members to the MyCl ass class. 

As you can see, the serialization class did exactly 
what it was supposed to do. In addition, note that 
the code for the serialization class has virtually no 
relation to the class from which it is called. This 
lack of specialization allows us to easily reuse the 
class as an interface to as many other classes as we 
want — allowing each of them to serialize the data 
efficiently. 

Also note that if you were suddenly instructed to 
change the output to a format other than XML, the 
code needs adjustment in only one place. This saves 
you time, avoids mistakes, and is in keeping with the 
best strengths of object-oriented programming. 
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uffer overlows occur in a majority of C or C++ programs. Imagine, 
for a moment, reading data from an input file. The typical C or C++ 
code might look something like this: 



char szBuf f er[80] ; 
int nPos = 0; 
while ( !eof(fp) ) 
( 

szBuf f er[nPos ] = fgetc(fp); 
if ( szBuffer[nPos] == ' | ' ) 

brea k ; 
nPos++; 



This routine is supposed to read in a string from the file, reading until it 
hits a pipe (|) character or the end of the file. But what happens if the 
string is longer than 80 characters? Well, in that case, the routine contin- 
ues to read in the string information, overwriting the memory locations 
that follow the szBuffer variable. We refer to this problem as a buffer 
overflow. What information is stored in those memory locations? Well, 
that's hard to say: Maybe there is nothing important there — or maybe 
an important return address for a function is being overwritten. In the 
former case, you might never see a problem. In the latter case, the pro- 
gram could easily crash, exposing a serious vulnerability to the outside 
world. 

Problems like this, known as buffer overflow, are really quite widespread 
in the software-development world — but unless they're causing major 
issues (or haven't been discovered yet), programmers tend to overlook 
them. Even so, buffer overflow is considered the number-one security 
problem in software today. Depending on the application, a buffer over- 
flow can crash the application, or simply destroy some vital part of the 
security wall that prevents an outside user from modifying data within a 
program. So why are we not doing something about it? 
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The simple answers look pretty silly: This is the way 
that we've always written code, the problem is not 
that sejacus, and we aren't going to change now. 

— iasonably easy to fix — and 
lo^BaJfao so. This technique 
stTows you how. By eliminating security risks, you 
will provide a safer application and minimize the 
amount of time you spend issuing security patches 
and dealing with customer support nightmares, 
which will save you a lot of time. 

Imagine, for example, rewriting the routine just given 
so it looks like this: 

Buffer szBuffer(80) ; 1 

int nPos = 0; 

try 

{ 

while ( !eof(fp) ) 
{ 

szBuffer[nPos] = fgetc(fp); 
if ( szBuffer[nPos] == ' | ' ) 

break; 
nPos++; 



This solution allows programs to behave in that 
ideal fashion of dealing with problems all by them- 
selves. Perhaps it is not possible to recover com- 
pletely from an error like this, but at least the 
program could exit in a safe manner, shutting down 
all connections and not allowing the operating sys- 
tem to be compromised. This is what software secu- 
rity is all about. The issue, then, is to create a class 
that implements that generic buffer and protects 
your data. That is the aim of this technique. 

Creating the Buffer Class 

The solution we are going to implement for buffer 
overflows is to create a class that protects the data 
buffer by allowing access to valid areas of the buffer 
only. This class overrides the operators that provide 
access to the individual characters of the buffer, and 
makes sure that all assignments, copies, and manip- 
ulations work only on valid sections of the buffer. 
Let's create that class now. 



catch ( Buf f erExcepti on& exc ) 
{ 

pri ntf ( " Buf f er Overflow!"); 

) 

return 0; 

Now, this code cannot crash the program. Unlike the 
earlier code, which used a static array, this program 
uses a Buffer class (see -* 1) to manage the buffer. 
The Buffer class would check to see that the underly- 
ing buffer was not overwritten, and prevent memory 
from getting stomped on. If either condition were to 
occur, the program would throw an exception — and 
recover gracefully. 



T 



Catching problems before they occur and 
spread to odd parts of the program will save 
you time and frustration later on down the 
line. If you build your programs as defensively 
as possible, you will limit the time you have to 
spend debugging them. 



f m In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch60 . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for your 
automation object. 

2. Type the code in Listing 60-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 60-1: The Buffer Class 

#i include <stdio.h> 
#include <string.h> 
#include <stdlib.h> 
#include <string> 

using namespace std; 

class Buf f erExcepti on -* 4 



(continued) 
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Listing 60-1 (continued) 



pri vate : 



l_ ^ i n g _e r nM s g ; 
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void ) 



_errMsg = " " ; 

Buf f erExcepti on ( const char *msg ) 

_errMsg = msg; 

Buf f erExcepti on ( const Buf f erExcepti on& 
aCopy ) 

_errMsg = aCopy ._errMsg ; 

const char *Message() 

return _errMsg.c_str( ) ; 

void setMessage( const char *msg ) 

_errMsg = msg; 



class Buffer 

{ 

private: 

// SMember: m_Buffer - This is the 
actual area of allocated memory, 
char *m_Buffer; 

// SMember: m_Size - This is the size of 

the allocated memory, 
i n t m_S i z e ; 
protected : 

virtual void pri nt_buf f er ( const char 
*strPrefix ) 

{ 

printf("%s: [", strPrefix ); 
for ( int i=0; i<m_Size; ++i ) 

printf ( "%c" , m_Buffer[i] ); 
p r i n t f ( " ] \ n " ) ; 



vi rtual void cl ear( ) 



if ( m_Buffer ) 

delete m_Buffer; 
m_Buffer = NULL; 
m_Size = 0; 

} 

virtual void copy( const Buffers aBuffer 
) 

{ 

m_Buffer = new char[ aBuf f er . Si ze ( ) 
]; 

memcpyt m_Buffer, aBuf f er ._Buf f er ( ) , 

aBuffer . Si ze( ) ) ; 
m_Size = aBuf f er . Si ze( ) ; 

} 

virtual void allocate( int nSize ) 
1 

m_Buffer = new char[ nSize ]; 
memset( m_Buffer, 0, nSize ); 
m_Size = nSize; 



const char *_Buffer(void) const 
1 

return m_Buffer; 



publ i c : 

// Void constructor. No memory is allo- 
cated or available. 
Buffer (void) 

: m_Buffer(NULL) , m_Size(0) 

1 

// Clear everything, 
cl ear( ) ; 

} 

// This is a standard constructor. 
Buffer( int nSize ) 

: m_Buffer(NULL) , m_Size(0) 

1 

cl ear( ) ; 

al 1 ocate( nSi ze ) ; 

} 

// Copy the constructor. 
Buffer( const Buffers aBuffer ) 
: m_Buffer(NULL) , m_Size(0) 

{ 

cl ear( ) ; 

copy ( aBuffer ) ; 
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virtual ~Buffer() 



cl ear( ) ; 
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Buffer &operator=( const Buffer& aBuffer) 
{ 

clear() ; 

copy ( aBuffer ) ; 
return *this; 

} 

Buffer &operator=(const char *strBuffer) 

{ 

// If they are assigning us NULL, 

just clear 
// everything out and get out of 

here . 
cl ear( ) ; 

if ( strBuffer == NULL ) 
return *this; 

// Otherwise, we need to set up this 
object 

// as the passed-in string. 
allocate( (int)strlen( strBuf f er )+l 
) ; 

memcpy( m_Buffer, strBuffer, 

strl en ( strBuffer ) ) ; 
return *this; 

} 

char& operator[] ( i nt nPos) -> 2 

{ 

if ( nPos < 0 | | nPos > m_Size-l ) 
throw Buf f erExcepti on ( "Buffer: 
Array index out of range" ); 
return m_Buffer[ nPos ]; 

} 

operator const char*() -> 3 

{ 

// Just give them back the entire 

buffer . 
return m_Buffer; 

} 

const char *c_str( void ) 

{ 

return m Buffer; 



/ Here come the accessor functions, 
nt SizeO const 

return m_Size; 



/ fhese are memory-based functions, 
void Sett char c ) 

for ( int i=0; i<m_Size-l; ++i ) 
m_Buffer[i] = c; 

void Cleart void ) 

Set( 0 ); 



Buffer operator( ) ( int nStart, 

int nLength) -> 4 

{ 

// Do some validation 

if ( nStart < 0 | | nStart > m_Size-l 



throw BufferExceptionC'Buffer: 
Array index out of range"); 

1 

if ( nLength < 0 | | nLength > 
m_Size-l || nStart+nLength > 
m_Size-l ) 

1 

throw Buf f erExcepti on (" Buf fer : 
Length out of range"); 



Buffer b(nLength+l) ; 
for ( int i=0; KnLength; ++i ) 
b[i] = m_Buffer[i+nStart] ; 

return b; 



In the code in the listing above, certain elements 
make it an important step up from the standard 
C++ character array. First of all, observe the way 
in which the characters are retrieved using the 
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indexing operator ([]). The operator[], shown 
at 2, carefully checks to see whether the index 
requ ested is within a valid ranee. If it is not, it 

)n. Similarly, the sub-string 
>t -> 4) checks to make sure 
that all of the characters are in the valid range. 
Unlike the character array, the Buffer class 
allows you to extract small segments of itself, but 
protects against those segments being invalid. 
Because the returned value is a Buffer object, 
this method is safe from overruns. You might 
notice the conversion operator, shown at the line 
marked -* 3; it appears to provide a way for the 
programmer to destroy the string. In fact, 
because it returns a constant pointer to the 
buffer, the programmer cannot directly change it 
without casting the string, a fact that the com- 
piler will be happy to note. The overall idea is 
that we are preventing the programmer from 
doing something that will cause problems with- 
out thinking about it more than once. 

3. Save the source code in the code editor. 



Notice that we create our own Excepti on 
class (shown at the line marked with -» 5) to 
return errors from the Buffer class. It's a good 
idea to have your own forms of exceptions, 
rather than using the basic types; that way the 
programmer can deal with system errors in 
ways that are different from programmatic 
solutions. 



Testing the Buffer Class 

After you create a class, you should create a test 
driver that not only ensures your code is correct, 
but also shows people how to use your code. The 
following steps show you how: 

f m In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch60 . cpp. 




2. Type the code from Listing 60-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

Listing 60-2: The Test Driver for the Buffer Class 

int maind'nt argc, char* argv[]) 
{ 

Buffer bl(20) ; 
Buffer b2; 



b2 = bl; 

bl = "This is a test"; -> 6 

printfC'The buffer is: %s\n", (const 

char *)bl) ; 
bl[2] = 'a' ; 

printfC'The buffer is: %s\n", (const 
char *)bl) ; 

try 
( 

bl[-l] = 'a' ; 7 

} 

catch ( Buf f erExcepti on& exc ) 
( 

pri ntf( "Caught the error: %s\n", 
exc.Messaget ) ) ; 



// Test the "sub-buffer" function. 
Buffer b3; 

b3 = bl(0,4) ; 

printfC'The new buffer is: ["); 
for ( int 1=0; i<b3.Size(); ++i ) 

printf("%c", b3[i] ); 
pri ntf ( " ] \n" ) ; 



return 0; 



The above code simply exercises some of the 
important functionality of the Buffer class. First, 
we check to see that the assignment operators 
work as they are supposed to. This is shown 
at -* 6 in Listing 60-2. Next, we test to see whether 
the indexing logic works properly, as shown 
at -> 7. If it is working properly, we would expect 
to see the exception thrown and printed out on 
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the console. Finally, we test the sub-string func- 
tions, by extracting a piece of the buffer and 
making it into a new Buffer object (shown at 
V^W/^QM^t?* ls working correctly, we 

puffer be the first four charac- 
ters of the original string. Let's test it out and see. 

3. Save the source file in the code editor and 
close the editor application. 

4. Compile the source file with your favorite com- 
piler on your favorite operating system. 

5. Run the application on your favorite operating 
system. 

If you've done everything right, you should see a 
session similar to this one on your console window: 

$ . /a . exe 

fhe buffer is: This is a test 
The buffer is: Thas is a test 
Caught the error: Buffer: Array index out 

of range 
The new buffer is: [Thas ] 



As you can see, the output is exactly what we 
expected. The error was generated and caught, and 
the exception information was printed to the con- 
sole. The sub-string was the characters we expected 
as well, indicating that both the original assignment 
and the sub-string operators are correct. By using 
this class, we can therefore expect to save a lot of 
time in debugging our applications and in develop- 
ing applications, because a lot of the functionality 
exposed makes it quicker to check input data. 

As you can see, this code offers greater safety. It 
sure beats allowing the buffers to be overrun and 
the memory to be stomped on. 
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Opening a File 
Using Multiple 
Paths 



Save Time By 

Adding code to allow 
users to specify search 
paths to files 

V Creating a multiple- 
search-path class 

V Testing your class 



It happens quite often when designing computer software: You ask a 
user to specify a file to open in your application, and then permit him 
to choose that file by "browsing" to the correct path. Unfortunately, 
there is no good way to utilize the underlying operating system to find 
specific files, especially if you want your application to be portable 
across various operating systems. It makes more sense, therefore, to 
build a method for actually looking across all search paths that might 
exist when you open a file automatically, without worrying about where 
they are, or how to get at them. 

This technique does the job by building a utility class that manages mul- 
tiple paths for searching files, using that class to find and read whichever 
file the user specifies. No magic here — just a handy way to utilize the 
built-in functionality of the C++ Standard Library functions to avoid the 
problems of using the operating system to find files, since this process is 
different for each operating system. There is nothing magical about 
searching various search paths and opening files, but combining the two 
into a single object provides some power and flexibility that you can uti- 
lize in numerous applications — with little effort on your own part. That, 
of course, is the entire point to building utility classes in C++: You get a 
lot of bang for your buck. 

The new utility class is responsible for three things: 



It stores the various paths used for searching and ensures that those 
paths are all valid. 

*>* It uses the input search paths to find a given file when the user speci- 
fies one. 

It opens the chosen file and returns a stream-object reference to the 
programmer for use in manipulating the file. The user can then find 
out where the file is — and read the file from the stream object as 
needed. The user may not know, or care, where the file they requested 
is actually located, so long as it can be found along one of the various 
search paths. 
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If you are storing various configuration files for 
your system, it's unlikely that the user will 
_store all the files in one place. For example, if 
: configuration files, 
: output report 

filesTancTso on, tRe user will probably want 
them stored in different locations. It's also 
likely that the user will sometimes forget 
which ones go where and put them in the 
wrong places. Rather than making the users 
do the work of finding all the files, you should 
define a set of possible search paths for the 
user. This approach saves time for the user, 
spares the programmer some grief, makes 
your application better received, and makes 
life a bit easier for all concerned. If you require 
that the user find each file, rather than search 
for it yourself in the most likely places, you 
make life harder for the user. If you make life 
harder for the user, they will use someone 
else's program. 



Creating the Multiple- 
Search-Path Class 

A utility class that allows the user to find a file by 
using multiple search paths simply makes good 
sense. The following steps create such a class, called 

Mul ti Path Fi 1 e: 

/. In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch61 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 61-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 61-1: The Multiple-Search-Path Utility Class 

#include <string> 
#include <vector> 
^include <fstream> 
#1nclude <iostream> 
#include <sys/stat.h> 

using namespace std; 

class Di rectory Li st 
{ 

private: 

vector< string > _entries; 
publ i c : 

Di rectory Li st ( voi d ) 

{ 

1 

Di rectory Li st ( const char *strDir ) 



_entri es . i nsert ( 
s t r D i r ) ; 



.entries .end( ) . 



Di rectory Li st( const Di rectory Li st& 
aCopy ) 

1 

vector<string>: : const_i terator 

iter; 
for ( iter = 

aCopy ._entri es . begi n ( ) ; iter != 
aCopy ._entri es . end( ) ; ++iter ) 
_entri es . i nsert ( 

_entri es . end ( ) , (*iter) ): 



bool is_dir( const char *strDir ) -> 1 
{ 

struct stat st; 

if ( stat( strDir, &st ) 



( 



0 ) -» 

if ( st.st_mode & S_IFDIR ) 
return true; 



(continued) 
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Listing 61-1 (continued) 



return false; 
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onst char *strDir ) 



_entries.insert( _entries.end(), 
s t r D i r ) ; 

} 

void removeEntry( const char *strDir ) 

{ 

vector<string>: : iterator iter; 
for ( iter = _entri es . begi n ( ) ; 
iter != _entri es . end( ) ; ++iter ) 

{ 

if ( (*iter) == strDir ) 
{ 

_entri es . erase( iter ); 



int count(void) const 

{ 

return _entri es . si ze( ) ; 



class Mul ti PathFi 1 e 

{ 

pri vate : 

Di rectory Li st _pathList; 

if stream _i n ; 

string _path; 
publ i c : 

Mul ti PathFi 1 e( voi d ) 
: _path("") 



Mul ti PathFi 1 e( const Di rectory Li st& 
aPathList ) 

: _pathList( aPathList ), 
_path( " " ) 



Mul ti PathFi 1 e( const char *strDir ) 
: _pathLi st( strDi r ) , 
_path( " " ) 



void addPath( const char *strDir ) 



Di rectory Li st operator+=( const char 
*strDir ) 

{ 

_entries.insert( _entries.end( ) , 

strDir ) ; 
return *this; 

} 

Di rectory Li st operator- = ( const char 
*strDir ) 



if ( _pathLi st . i s_di r( strDir ) ) 
_pathLi st . addEntry ( strDir ); 

el se 

pri ntf ( " Inval i d path: 
[%s]\n" , strDi r ) ; 

id removePath( const char *strDir ) 

_path Li st . removeEntry ( strDir ); 



removeEntry( strDir ); 
return *this; 



string getEntry( int idx ) 

{ 

if ( idx < 0 | | idx > count ( )-l ) 
throw "Di rectory Li st : Array 
Index out of range"; 

return _entries[ idx ]; 



bool open( const char *strFi 1 eName ) -s 
( 

for ( int i=0; 

i<_pathList.count( ) ; ++i ) 

{ 

string sDir = 

_pathList.getEntry( i ); 
string sFullPath = sDir + 

strFi 1 eName ; 
_in.open( s Ful 1 Path . c_str ( ) , 

i os : : i n ) ; 
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if ( !_in.fail () ) 
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path = sDir; 
return true; 

ear() ; 



return false; 

oid closet) 

_i n . cl ose( ) ; 

fstream& file(void) 
return _in; 

tring CurrentPath ( voi d ) 
return _path; 



3. Save the source code in the code-editor 
application. 

The code above breaks down into two classes: 

The Di rectoryLi st class: This class simply 
maintains a list of various directories in the sys- 
tem and allows the programmer to have a single, 
consistent way to access directory names. There 
is nothing really surprising in this class; it is just 
a wrapper around the Standard Template Library 
(STL) vector class that does a bit of extra check- 
ing to see if a given name is a directory. (See the 
i s_di r method, shown at -> 1.) 

v 0 The Mul ti PathFi 1 e class: This is really an 
extended version of the basic file classes sup- 
plied by the STL. It maintains a list of directories 
to search by using the Di rectory Li st class to 



hold the various directories. When an open 
request is received via the open method, as 
shown at -* 2, the class iterates through the var- 
ious directories in its list and tries to open the 
file in each one. If the file is found in a given 
directory, it stores the directory path where the 
file was found and returns a handle allowing the 
programmer to access the file. 

These two classes (Di rectoryLi st and 
M u 1 1 i P a t h F i 1 e) do all of the work of managing the 
search paths and then utilizing those search paths 
to open and manipulate the file. Notice the use of 
stat (a standard C function ) shown at the line 
marked -* 3 to check whether an input path is valid 
and is a directory. 

Note that you will need to add search paths to the 
system using the path delimiter (which is the for- 
ward or backward slash, depending on the operating 
system you're working with) appended to the end of 
the path. That is, you have to enter c : / wi ndows/ 
rather than simply c: /wi ndows, because the system 
will not append the delimiter for you. This could eas- 
ily be fixed, but would require even more code in 
what is already a fairly long listing. 

Testing the Multiple-Search- 
Path Class 

After you create a class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 
The following steps tell you how: 

/. In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch61 . cpp. 
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2. Type the code from Listing 61-2 into your file. 

Better yet, copy the code from the source file on 
HsJbaqk'sy^iliuaBifiri Web site. 




Listing 61-2: The Multiple-Search-Path Test Program 

void di spl ay_f i 1 e( ifstream& in ) 

{ 

// Display the first 100 characters 
cout << endl ; 

for ( int i=0; i<100; ++i ) 



char c ; 
in.get(c) ; 
if ( Mn.failO ) 
cout << c; 

else 

break ; 



cout << endl ; 



! 



int main( int argc, char **argv ) 

{ 

Mul ti PathFi 1 e paths; 

// First, add in all the paths 
for ( int 1=1; Kargc; ++i ) 

{ 

paths . addPath ( argv[i] ); 



// Now ask them what they want to do. 
bool bDone = fal se ; 
while ( IbDone ) 

{ 

char szPath[ 256 ] ; 
char szFi 1 e[ 256 ] ; 

pri ntf ( "Opti ons : \ n" ) ; 
printf("(l) Add a new search 

path\n" ) ; 
printf("(2) Open a file\n"); 
printf("(3) Exit the 

program\n\n" ) ; 
printfC'What do you want to do? 

int option = 0; 
scanf("%d", &option ); 



getchar( ) ; 
switch ( option ) 

{ 

easel: -> 4 

pri ntf (" Enter search 

path to add : " ) ; 
memsett szPath, 0, 



sizeof (szPath) 



gets ( szPath ) ; 

if ( strlen(szPath) ) 

paths . addPath( 

szPath ); 
break ; 

case 2 : -> 5 

pri ntf (" Enter file to 

open : " ) ; 
memsett szFile, 0, 

si zeof ( szFi 1 e) ) ; 
gets ( szFi 1 e ) ; 
if ( strl en ( szFi 1 e ) ) 
if ( !paths.open( 
szFile ) ) 

pri ntf ( "Error 
finding file 
%s\n" , 
szFile ) ; 

else 
1 

pri ntf ( " Fi 1 e 
found at: 
[%s]\n", 
paths . Curren 
tPath() .c_st 
r() ); 

di spl ay_f i 1 e( 
paths . f i 1 e( ) 
); ->7 

} 

break ; 

case 3 : -> 6 

bDone = true; 

break ; 
def aul t : 

pri ntf ( " Inval i d 
Opti on\n" ) ; 

break; 



return 0; 
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The above code tests the multiple search paths 
to open files. When run, the program allows the 
er to add various search paths to their list of 
c4oiuQ(^b>l^e^!ben allows them to search for 
H^fsVa^lfi\s^5aths. If the user wants to add 
a new search path, he enters T at the prompt, 
which falls into the code at -> 4. This code gets a 
path name from the user and adds it to the search 
path list. If the user wants to find a file, he enters 
'2' at the prompt, and the program prompts for 
the filename to search for (see -* 5). If it is found, 
it will be printed out along with the path that it 
was found in. Finally, entering '3' at the prompt ter- 
minates the loop and exits the program (see -* 6). 

5. Save the source code in your code editor and 
then close the editor application. 

4. Compile the application using your favorite 
compiler on your favorite operating system. 

$ m Run the application in the console window of 
your favorite operating system. 

If you have done everything right, you should see a 
session that looks something like this: 

$ . /a . exe 
Opti ons : 

(1) Add a new search path 

(2) Open a file 

(3) Exit the program 



What do you want to do? 1 

Enter search path to add: c:/windows/ -* 10 
Opti ons : 

(1) Add a new search path 

(2) Open a file 

(3) Exit the program 

What do you want to do? 2 

Enter file to open: DAfECL.h -> 11 

File found at: [c:/work/] -* 12 

/* 

* + 

*| Header : DAfE 

Opti ons : 

(1) Add a new search path 

(2) Open a file 

(3) Exit the program 

What do you want to do? 3 

As you can see, the utility class went through the list 
of paths I gave it (shown at lines -* 8, -> 9, and -> 10), 
found the one that matched the filename that was 
input (shown at -» 11), opened the file, and allowed 
me to read it. In addition, it returned the path to 
where the file was found (shown at -> 12); I can 
output that data to the user of the application. 
The file is displayed via the di spl ay_f i 1 e call in 
Listing 61-2 at line -» 7. 



What do you want to do? 1 

Enter search path to add: c:/matt/ -> 8 

Opti ons : 

(1) Add a new search path 

(2) Open a file 

(3) Exit the program 

What do you want to do? 1 

Enter search path to add: c:/work/ -* 9 

Opti ons : 

(1) Add a new search path 

(2) Open a file 

(3) Exit the program 



Improving the class 

The class as it stands is very useful, but would benefit from 
a capability that saves the paths to some form of persistent 
storage and then reads them back from the storage file at 
program startup. The user would only have to enter the 
paths once. In addition, the program does not use relative 
file paths for some operating systems (such as ~ in Unix), 
because of the way in which the open is done. This could 
be improved as well. 
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If you have ever tried to debug an application that you didn't write, you 
know that the biggest challenge is simply figuring out how the program 
got into its present state to begin with. Quite often, while the individual 
components of a system are well documented, the overall flow of the sys- 
tem is not. There is no real way for you to know how the program got from 
the initial entry point to the point at which the problem occurred without 
stepping through each and every line in the debugger. Given the number 
of levels in the average production-quality C++ program, it can take hours 
to get from the beginning of the program to the problem spot. Wouldn't it 
be nice if you could just look through the source code for potential prob- 
lems and trace through the code path that you knew the system was tak- 
ing to get from point A (an entry point into the system) to point B (where 
the problem occurs)? Of course it would. 

In general, what prevents us from having the data we need to trace from 
one point in the program to the core of the system is a lack of informa- 
tion about the path that is taken. Most debuggers can show you a call 
stack of how you got somewhere, but that stack goes away when you 
stop running the program. Worse, because the call stack shows you 
absolutely everything that goes on, you will often find yourself chasing 
problems in the system libraries and language code, rather than the 
more likely problems in your own code. What you really need to know is 
the path through your code that was used, not every call into the alloca- 
tion libraries or string functions. This means we need a way to trace 
through our own code only, and show where we are at any given time. 

Of course, the obvious solution here is simply to build a tracing capability 
into our applications. Okay, how do you go about this? The easiest way is 
to create a C++ class that can "report" where we are in the program, and 
to then have that class talk to a "manager" process that can print out a 
complete trace tree, showing how we got there. That, in a nutshell, is the 
purpose of this technique. 
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'iitt; we neea to implement the definition of the flow 
trace class. The flow trace class allows us to track 
what happens in the program, and to quickly and 
easily display a list of all of the functions that were 
called from the point the process was begun to when 
the problem occurred. 



In the code editor of your choice, create a new 
file to hold the code for the definition of the 
source file. 

In this example, the file is named ch62 . cpp, 
although you can use whatever you choose. 

2, Type the code from Listing 62-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 62-1: The Flow Trace Class Definition 

^include <string> 
^include <stack> 
#include <vector> 

class debugFl owTracer 
{ 

private: 

std::string m_s Fl owName ; 

std::vector< debugFl owTracer > m_acti vef uncti onStack ; 
bool m_bRemoved ; 

protected : 

virtual void AddFlowO; 

virtual void RemoveFl ow( ) ; 

publ i c : 

debugFl owTracer ( void) 
{ 

m_sFl owName = "Unknown"; 
m_bRemoved = False; 
AddFl ow( ) ; 

} 




debugFl owTracer( const char *strFlow) 
{ 

m_sFl owName = strFlow; 
m_bRemoved = False; 
AddFl ow( ) ; 

} 

debugFl owTracer( const debugFl owTracer& aCopy ) 
{ 

m_sFl owName = aCopy .m_sFl owName ; 

std::vector< debugFl owTracer > : : const_i terator iter; 
For ( iter = aCopy . m_acti veTuncti onStack . begi n ( ) ; iter != 
aCopy . m_acti veTuncti onStack . end( ) ; ++iter ) 

m_acti veFuncti onStack . i nsert( m_acti veFuncti onStack. end( ) , (*iter) ); 

} 



Implementing the Flow Trace Class 



-debug Fl owTra cert void) 



if ( !m_bRemoved ) 
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std : : stri ng Name( ) 
return m_sFlowName; 

void AddSubFlowt debugFl owTracer& cSubFlow ) 

// Just push it on top of the active function stack. 

m_acti vef uncti onStack . i nsert ( m_acti vef uncti onStack . end ( ) , cSubFlow ); 
void Pri ntStackt i nt i Level) 

std::vector< debugFl owTracer >::iterator iter; 

for ( iter = m_acti vef uncti onStack . begi n () ; iter != m_activefunctionStack.end( ) ; ++iter ) 

{ 

for ( int i=0; i<i Level; ++i ) 

putchar ( ' \t ' ) ; 
pri ntf ( "%s\n" , (*iter) .Name( ) .c_str( ) ); 
(*i ter) . Pri ntStackt i Level +1 ) ; 



The flow trace object (debugFl owTrace) contains 
a name that you can use for defining specific 
entry points into the system — such as when the 
user starts using a feature such as saving a file. It 
also contains a list of sub-flows, which are simply 
the functions that are entered when the flow 
begins. If you start in function one, call function 
two and four, in which function two calls function 
three, you would have a trace that looked like 
this: 

Function One 

Function Two 
Function Three 
Function Four 



This listing could be easily generated by the flow 
trace object. 

3. Save the source code as a file in the code editor 
of your choice. 

4. Append the code from Listing 62-2 to your file. 

This will contain the debugFl owTracerManager 
class. 

Better yet, copy the code from the source file on 
this book's companion Web site. 
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Listing 62-2: The Flow Trace Class and Manager Implementation 



l_ ^ cl a##^JebugFl owTracerManager 
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std::stack< debugFl owTracer> m_f uncti onStack; 
static debugFl owTracerManager *m_Instance ; 

publ i c : 

static debugFl owTracerManager *Instance() 

{ 

if ( m_Instance == NULL ) 

m_Instance = new debugFl owTracerManagert ) ; 
return m_Instance; 

} 

void addFlow( debugFl owTracer& cFlow ) 

{ 

m_functionStack.push( cFlow ); 

} 

void removeFl ow(debugFl owTracer& cFlow) 

{ 

if ( m_functionStack.empty( ) ) 
return ; 

// Get the top element. 

debugFl owTracer t = m_functionStack.top( ) ; 

// Remove it. 
m_functionStack.pop( ) ; 

// If there is anything left, add it. 
if ( m_functionStack.empty( ) ) 

{ 

printfC'Flow [%s]:\n", t . Name( ) . c_str ( ) ): 
t.PrintStack(O) ; 



el se 



m_f uncti onStack . top( ) .AddSubFl ow( t ); 



pri vate : 

debugFl owTracerManagert ) 



debugFl owTracerManager(const debugFl owTracerManager& aCopy ) 



virtual -debugFl owTracerManager ( voi d ) 



}; 



Testing the FtoW Trace System 



debugFl owTracerManager *debugFl owTracerManager : :m_Instance = NULL; 
void debugFl owTracer : :AddFl ow( ) 

inager : : Instance( ) ->addFl ow( *this ); 
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void debugFl owTracer : : Remove Fl ow( ) 
{ 

debugFl owTracerManager ::Instance() ->removeFl ow( *thi s 



The purpose of the debugFl owTracerManager class is 
to keep track of the various flows within the system. 
Because a flow can really start and end anywhere in 
the source code of the application, we need a single 
place to store all of them. This allows us to print 
them out at the point that gives us the best view of 
how the processing went. The flow manager con- 
tains a single method, Instance (shown at -* 1), to 
return an instance of the class. Otherwise, you will 
notice that the constructors are all private, so that 
users cannot create an instance of the class. This 
ensures that there is only a single object of this class 
in any given application. 



Testing the FtoW Trace System 

After you create a class, you should create a test 
driver that not only ensures your code is correct, 
but also shows people how to use your code. The 
following steps tell you how: 

f m Append the code from Listing 62-3 into your 
source file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 62-3: The Flow Trace Test Program 



debugFl owTracer f 1 ow( "f unc_3" ) ; 



void func_ 


deb 


jgFl 


void f 


jnc_ 


deb 


jgFl 


fun 


:_3( 


void f 


jnc_ 


deb 


jgFl 


func_2( 



nt maintint argc, char* argv[]) 

debugFl owTracer mai nFl ow( "mai n" ) ; 
f unc_l ( ) ; 
func_2( ) 
f unc_3 ( ) 
return 0 



The test driver is constructed to illustrate the way 
in which the flow manager works. Note that we 
simply define a debugFl owTracer object in each of 
the functions in the code, and then use the func- 
tions as we would normally. The debugFl owTracer 
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Drop 



object attaches itself to the the instance of the 
manager (shown back in Listing 62-2 at -* 2) and 
s itself as a. flow when it is created. The man- 
1 of the flows, printing them 
t\<iiJ"poses as they are created. 





2. Save the source code in the source-code editor 
and close the source-editor application. 

3. Compile the application using your favorite 
compiler on your favorite operating system. 

4. Run the application on your favorite operating 
system. 

If you have done everything properly, you should 
see the following output in the console window of 
your operating system: 



$ 


./a 






Fl 


ow 


[mai n! 




F" 


ow 


[f unc_ 


1]: 


Fl 


ow 


[f unc_ 


2]: 


F" 


ow 


[f unc_ 


3]: 


F" 


ow 


[f unc_ 


2]: 


f unc_ 


3 




F" 


ow 


[f unc_ 


3]: 



As you can see, the program indicates what flows are 
running in the application, and how it got from one 
point to another. The names of the flows are printed 
within the square brackets as they are created. When 
a flow goes out of scope (when the function ends) the 
sub-flows (calls within that function) are printed out. 
You can see that in our case, only one of the functions 
called calls another function. This is shown in the 
listing at the line marked with 3, indicating where 
f unc2 called f unc3. This gives us a good example of 
tracing and shows us how f unc3 was called through- 
out the program. 



Adding in Tracing 
After the Fact 



One of the more annoying things in the software world 
is being told to add something to your application 



after it has been designed, coded, and released. 
After all, you say, if it was up to you, the code would 
have been in there in the first place. Why should you 
pay for the mistakes of the developers before you? 
The answer is, because that's the way the world 
works. Someone comes along, writes a bunch of 
ugly, unmaintainable code, and then moves on to do 
it again someplace else. You get to move in and fix 
the disaster that was left behind. 

Fortunately, this isn't really one of those times. It is 
possible to add in flow tracing after the fact, even 
automating the process. Let's create a simple little 
application that will do just that. 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch62a.cpp, 
although you can use whatever you choose. 

2, Type the code from Listing 62-4 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



A word of warning 

Before you use the insertion program, here are a few things 
you need to know about it: 

v 0 Consider it a jumping-off point for your own cre- 
ations. It is not intended to be used in a production 
environment. Using it that way is likely to confuse the 
program; its interaction with complex programs may 
require you to update the output. (That is why it 
does not overwrite your original source.) 

u* It does not handle all cases. Inline code in a class will 
not be detected and updated. 

t>* The code will sometimes detect a function or 

method when one does not exist. For example, the 
code will sometimes make this mistake in a macro. 

The insertion program will insert tracing objects in most, 
but not all, of your application functions with the exceptions 
listed in the notes above. Use it in good health. 
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Listing 62-4: A Utility Program to Insert Tracing into an Existing File 

#i include <string> 




fp, std : : stri ng& real_line ) 



// Just read to the end of the line, 
while ( !feof(fp) ) 

{ 

char c = fgetc(fp) ; 
real_l n ne += c ; 
if ( c == '\n' ) 
break; 

} 

} 

void eat_comment_bl ock( FILE *fp, std::string& real_line ) 

{ 

char sLastChar = 0; 

// Find the matching comment-close character, 
while ( Ifeof(fp) ) 

{ 

char c = fgetc(fp) ; 
real_l i ne += c ; 

if ( c == '/' && sLastChar == '*' ) 

break; 
sLastChar = c; 



std::string get_line( FILE *fp, std::string& real_line ) 

{ 

std :: stri ng s Li ne = " " ; 
char sLastChar = 0; 
while ( !feof(fp) ) 

{ 

// Get an input character, 
char c = fgetc(fp) ; 

real_l i ne += c ; 

// Check for pre-processor lines. 

if ( c == '#' && (sLastChar — 0 | | sLastChar == '\n') ) 

{ 

eat_line( fp, real_line ); 
conti nue ; 

} 



(continued) 
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Listing 62-4 (continued) 

II Check for comments. 




real_l i ne += c ; 



if ( c == '/' ) 

( 

eat_line( fp, real_line ); 
sLastChar = 0; 
conti nue ; 

} 

else 

if ( c == '*' ) 

( 

eat_comment_bl ock( fp, real_line ); 
sLastChar = 0; 
conti nue ; 

} 

else 

{ 

sLine += sLastChar; 

} 

} 

// Need to skip over stuff in quotes. 

if ( c != '\r' && c != '\n' ) 

{ 

// Here it gets weird. If the last character was 

// a parenthesis, we don't want to allow white space. 

if ( sLastChar != ')' || !isspace(c) ) 

sLine += c; 
else 

conti nue ; 



// A line terminates with a { , a ) , or a ; character, 
if ( c == ' ; ' | | c == ' ( ' | | c == ' } ' ) 
break ; 




sLastChar = c; 

} 
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return sLine; 

} 




// First, find the opening parenthesis, 
int sPos = ( i nt ) s Li ne . f i nd ( ' ( ' ) ; 

// Skip over everything that is a space before that, 
for ( int i=sPos-l; i>=0; --i ) 
if ( ! i sspacet s Li ne[i ] ) ) 

{ 

sPos = i ; 
break; 

} 

// Now everything backward from that is the name, until 
// we hit either the beginning of the line or white space, 
int sStartPos = 0; 
for ( int i=sPos; i>=0; --i ) 

{ 

if ( i sspacet s Li ne[i ] ) ) 

break; 
sStartPos = i ; 

} 

sName = s Li ne . substr ( sStartPos, sPos-sStartPos+1 ); 
return sName; 

} 



void ProcessFilet FILE *fp, FILE *ofp ) 

{ 

std::string real_line; 

while ( !feof(fp) ) 

{ 

real_l i ne = " " ; 

std::string sLine = get_line( fp, real_line ); 
// Check for functions/methods. 

(continued) 
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Listing 62-4 (continued) 



^ _^ information 
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sLi ne[sLi ne 



// Output the "real" line, and then (if we need to) the 
we need to embed. 

real_l i ne . c_str( ) ) ; 
e.length( )-l] == '{' && 
.length()-2] == ')' ) 



std::string sName = parse_f uncti on_name( sLine ); 

f pri ntf ( of p , "\n\tdebugFl owf racer fl ow( \"%s\" ) ; \n" , sName . c_str( ) ) 



1 



int main(int argc, char* argv[]) 
{ 

if ( argc < 2 ) 
{ 

pri ntf ( "Usage : cppparser filename [f i 1 ename . . . ]\n " ) ; 
exit(l) ; 

} 

for ( int i=l; i<argc; ++i ) 
{ 

FILE *fp = f open ( argv[ i ] , "r"); 

if ( fp == NULL ) 

{ 

pri ntf (" Error : Unable to process file %s\n", argv[i] ); 
conti nue ; 

std::string sOut = std : : st r i ng ( a rgv [ i ] ) + ".tmp"; 
FILE *ofp = fopen(sOut.c_str( ) , "w"); 
if ( ofp == NULL ) 
f 

pri ntf (" Error : Unable to create output file %s\n", sOut.c_str() ); 
conti nue ; 



// Process this file 
ProcessFi 1 e( fp , ofp ) ; 

// Finish it up 
fcl ose(fp) ; 
fcl ose(ofp) ; 



return 0; 
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There is nothing magical about Listing 62-4. The 
code takes an input file and writes it out to an 
Jput temporary file, appending certain infor- 
Iq/rpwJfae lile aswt parses the text within the 
yj6\fljb[i^p^fc, the code is looking for 
opening braces (shown at -> 4) to indicate the 
beginning of a function. When one is encountered, 
it parses the function name (shown at -* 5) and 
writes a debugFl owTracer object definition into 
the output file. This creates an automated sys- 
tem for inserting flow tracing into an existing 
source file. 

3. Save the source code in the source-code editor. 

4. Create a new file in the source-file editor to use 
as a test input to the insertion program. 

This file simply acts as test input for the pro- 
gram; it doesn't really have to do anything on its 
own. For now, just create a file that contains 
some functions and some class methods. 

In this example, the file is named temp . cpp, 
although you can use whatever you choose. 

£ m Type the code from Listing 62-5 into your 
new file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 62-5: A Temporary Program to Illustrate Trace 
Insertion into an Existing File 

#include <stdio.h> 
#i include <string> 
#i include <iostream> 

int funcK) 

{ 

printf ("This is a test\n"); 



void func2() 

{ 

printf ( "This is another test\n" 

} 



class Foo 
{ 

publ i c : 
Foot); 

virtual ~Foo(! 

); 

Foo : : Foot voi d ) 



Foo: :~Foo(void) 
1 



int mainO 
{ 

Foo x ; 



Don't spend any time studying the code in 
Listing 62-5; its sole purpose is to provide an 
input file to test out the parser. If it works prop- 
erly, we will see an output file which contains 
debugFl owTracer objects in fund, f unc2, and 
the constructor and destructors for the Foo 
object and the main function. 

6. Compile the insertion program with your 
favorite compiler on your favorite operating 
system. 

7[ Run the program on your favorite operating 
system. 

If you have done everything right, you should see 
a file called temp . cpp . tmp created that contains the 
following text in it: 

^include <stdio.h> 
^include <string> 
#1nclude <iostream> 

int funcK) 
{ 

debugFl owTracer fl ow( "fund" ) ; -* 6 
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printfC'This is a test\n"); 
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debugFl owTracer f 1 ow( "f unc2" ) ; 



printfC'This is another test\n"): 



class Foo 

{ 

publ i c : 
Foo( ) ; 

vi rtual ~Foo( ) ; 



Foo: : Foo(void) 

{ 

debugFl owTracer f 1 ow( " Foo : : Foo" ) 7 



} 

Foo: :~Foo(void) 

{ 

debugFl owTracer f 1 ow( " Foo : :~Foo" ) ; 

I 

i nt mai n ( ) 
1 

debugFl owTracer f 1 ow( "main" ) ; 

Foo x; 

} 

Note that the program properly inserted all of the 
flow-tracing objects into the existing file. The lines 
marked -* 6 and -» 7, for example, show you that 
the output is exactly what we wanted and expected. 
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When you are debugging an application, having a set of techniques 
and tools that you can drop into an application will aid you in the 
process of finding and eliminating bugs. These techniques break 
down into two general categories: 

Macros used to debug techniques 

Classes used in your application to debug the code itself 

This technique looks at the sorts of things you can do to build up your 
own toolbox of debugging techniques and find the ones that work for 
you. As with most programming, there is no "right" or "wrong" way to 
debug a problem. There are techniques that work better for some people 
than others, and it is up to you to discover the ones you like best — and 
that work most efficiently. By having a library of macros that you can 
immediately drop into your application, you will save time developing 
and debugging code. 



When it comes to debugging, one size definitely does not fit all. The 
number of kinds of techniques that people swear by is limited only 
by the number of programmers using them. To save time for yourself 
and your application development, you should pick the techniques 
that work for you and stick with them. 




The assert Macro 

The first technique we will look at is the assert macro. The assert macro 
is a simply defined C++ standard macro that evaluates a single argument. 
If that argument is true, the code continues processing. If the argument is 
false, the program prints out a diagnostic error message and terminates 
abruptly. The catch is that the assert macro is only defined when the 
program is not being compiled in optimized mode. An assert is turned 
"on" when it is checking values and printing out error messages. Asserts 
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are turned off when they do nothing. In program- 
ming parlance, we say that the program is in "debug 
mode" io^a ssert to.work, and in "release mode" if 
rVirffV)lj/L0Js look at an example of 
oit*»e Bi*e &t&ew iVitoero in your own code. 

f. In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch63 . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for your 



automation object. 


2. Type the code 


in Listing 63-1 into your file. 


Better yet, copy the code from the source file on 
this book's companion Web site. 


Listing 63-1: Using the 


assert Macro 


#i include <asser 
#i include <strin 
#i include <stdli 


t.h> 
j.h> 
3.h> 


int func( int v 


ItolO ) 


{ 

assert( vltol 


0 >= 1 && vltolO <= 10 ); -» 1 


int divisor 


= 0; 


switch ( vlt 


DlO ) 



case 1: 

case 2 : 

case 3: 

case 

case 

case 

case 7 : 

case 

case 

case 10: 
divisor 
break ; 



vltolO 



int retVal = 200 / divisor; 
return retVal ; 



int maind'nt argc, char **argv) 



func(3) ; 
func(ll) ; 
return 0; 



In the listing above, our function (f unc) accepts an 
integer value. We expect the input value to be in 
the range of one to ten, inclusive. Values outside 
of that range will cause a division-by-zero error 
in the function, so we want to make sure that the 
user doesn't supply such a value. The assert 
statement (shown at the line marked -> 1) traps 
for such a condition and exits the program if the 
value input is outside the specified range. 

3. Save the file in the source-code editor and close 
the editor application. 

4. Compile the source-code file with your favorite 
compiler on your favorite operating system. 

S m Run the program on the console window of 
your favorite operating system. 

If you have done everything correctly you should 
see the following output on the console window: 

$ ,/a.exe 

assertion "vltolO >= 1 && vltolO <= 10" 

failed: file "ch8_la . cpp" , line 7 
Aborted (core dumped) 

The output indicates that the assert function trig- 
gered and the program exited. The actual text you 
see will be dependent on your operating system, 
compiler, and function library, but it will look similar 
to this. The important aspect is that the assert macro 
tells you what file and line the error occurred on and 
the assertion statement that failed. This will provide 
you valuable debugging information for determining 
how the program failed. 
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If you compile the source code with optimization on, 
you will see only the core-dumped message (or your 
operating system's equivalent of a divide-by-zero 





The assert macro is useful during the initial 
development phase of an application, but it 
fails to catch run-time errors when the applica- 
tion is released to the user. For this reason, you 
should never count on assert statements to 
catch all possible errors. 



The next logical type of debugging technique is the 
logging approach. Logging is the writing of data per- 
sistently in your application in order to facilitate 
debugging and maintenance. Much like a black box 
on a crashed airliner, logging records the steps the 
program took so you can understand how it got into 
the state it's in. Unlike some other techniques, log- 
ging can be used in either development mode or 
user-release mode. You can even turn it on or off at 
run-time — and even during program execution — to 
see exactly what is going on. The following steps 
show you how to implement a logging class. 



When you can turn your logging capability on 
or off at will, you can zero in on a problem 
much more quickly — which allows you to fil- 
ter out extraneous program information and 
see only what's pertinent to the problem. In 
this way, logging will save you a lot of time 
when you're trying to debug a program 
defect. 

In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch63a . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for your 
automation object. 



2. Type the code in Listing 63-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 63-2: A Logging Class 

^include <iostream> 

#include <string> 

#indude <stdlib.h> 

#include <stdarg.h> 

^include <fstream> 

using namespace std; 

class Logger 
1 

bool _bOn; 
bool _bForceFl ush ; 
string _sMessage; 
string _sFileName; 
ofstream _file; 




pub 



l c : 

ogger( void ) 

_bOn = false; 
_bForceFlush = false; 

oggert const char *strFileName ) 

_sFileName = strFileName; 
_bOn = false; 
_bForceFlush = false; 

oggert const Logger& aCopy ) 

_sFileName = aCopy ._s Fi 1 eName ; 
_bForceFlush = aCopy ._bForceFl ush ; 
setOn( aCopy ._bOn ) ; 

irtual ~Logger() 

FlushO; 
if ( _bOn ) 

_f i 1 e . cl ose( ) ; 



void setOnt bool flag ) 



(continued) 
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Listing 63-2 (continued) 
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file.openC _s Fi 1 eName . c_str( ) ); 



void Flush( void ) 

{ 

if ( _bOn ) 

_file << _sMessage << endl 
_sMessage = " " ; 



bool getOnt void ) 

{ 

return _bOn; 

) 

void setForceFl ush( bool flag ) 

{ 

_bForceFlush = flag; 

} 

bool getForceFl ush( void ) 

{ 

return _bForceFl ush ; 

} 

void setFileName ( const char 
*strFi 1 eName ) 

{ 

_sFileName = strFileName; 

} 

string getFileName ( void ) 

{ 

return _sFileName; 

} 

void Log( const char *strMessage ) 

{ 

_sMessage += strMessage; 
_sMessage += ' \n ' ; 
if ( _bForceFlush ) 
Fl ush( ) ; 

} 

void LogString( const char *fmt, ... 

{ 

char szBuffer[256] ; 
va_l i st ma rker ; 

va_start( marker, fmt ); /* 
Initialize variable arguments. */ 

vspri ntf ( szBuf f er , fmt, marker ); 

_sMessage += szBuffer; 
_sMessage += ' \n ' ; 
if ( _bForceFlush ) 
Fl ush( ) ; 



The Logger class can be used to do a more 
extensive information capture within an applica- 
tion. You can log virtually anything you want, 
regardless of whether the program is compiled in 
a debug (development) or release (production) 
mode. Logging can be turned on or off, even at 
run-time, allowing you to configure your system 
whenever you want without recompiling the pro- 
gram. The Logger class accepts a filename in 
which it will write all of its output (see -* 2), and 
writes out strings using either a simple string for- 
mat (see -> 3) or a more complicated formatted 
output (see -* 4). This makes the logging class 
ideal for inserting into your program and keeping 
track of important events for either debugging or 
customer support purposes. 

3, Save the source file in your code editor. 



Testing the Logger Class 

After you create a class, you should create a test 
driver that not only ensures your code is correct, 
but also shows people how to use your code. The 
following steps show you how: 

f m In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch63a . cpp. 

2. Type the code from Listing 63-3 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 
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Listing 63-3: The Logger Class Test Driver 



int maind'nt argc, char **argv) 
»xt" ) ; 
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// Make the log write things out as it encounters strings, 
// to avoid crashes wiping out the log. 
1 og . set ForceFl ush ( true ); 

// First, see whether the code told us to log anything, 
for ( int i=0; i<argc; ++i ) 

{ 

if ( ! strcmpt argv[i ] , "-log") ) 

{ 

1 og . setOn ( true) ; 
break; 

} 

} 

1 og . Log (" Program Startup Arguments"); 
for ( int i=0; i<argc; ++i ) 

{ 

1 og . LogStri ng (" Input Argument %d = Is", i, argv[i] ); 

// Prompt for a string, modify it, and then write it out. 
while ( 1 ) 

{ 

pri ntf( " Enter command: "); 
char szBuffer[ 80 ]; 
memsett szBuffer, 0, 80 ); 
if ( gets(szBuffer) == NULL ) 
break; 

1 og . LogStri ng (" Input String: %s", szBuffer ); 
if ( Istrlen(szBuffer) ) 

{ 

break; 

} 

string s = " " ; 

for ( int i =strl en ( szBuffer )- 1 ; i>=0; --i ) 
s += szBuffer[i]; 

1 og . LogStri ng ( "Output String: Is", s.c_str() ): 

} 



1 og . Log (" Fi ni shed with appl i cati on\n" ) ; 
return 0; 

} 
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The above code listing is a simple program that 
accepts a certain number of input arguments, 
jrints them oujt, and then prompts the user for 
tould do just about anything 
arguments or the com- 
mands, but that really isn't important for our 
purposes. Just to modify the string for output, 
we reverse the characters in the output string. 
We log the input arguments, as well as the input 
string and output strings in the command loop. 
This indicates any potential problems with spe- 
cific strings. 

3. Save the source file in your code editor and 
close the editor application. 

4. Compile the source file with your favorite com- 
piler on your favorite operating system. 

5. Run the application. 

If you have done everything properly, you should 
see the following output on your command console: 



$ . /a -log 






Enter command: 


H 


el 1 o world 


Enter command: 


G 


oodbye cruel world 


Enter command: 


H 


el 1 o agai n 


Enter command: 






$ cat log.txt 






Program Startup 


Arguments 


Input Argument 


0 


= ./a 


Input Argument 


1 


= -1 og 


Input String: 


He 


1 1 o world 


Output String: 


d 


1 row ol 1 eH 


Input String: 


Goodbye cruel world 


Output String: 


d 


1 row 1 eurc eybdooG 


Input String: 


He 


11 o again 


Output String: 


ni aga o 1 1 eH 


Input String: 






Finished with 


appl i cati on 



As you can see from the above listing, the log file 
contains all of the arguments, as well as the input 
and output strings from our session with the com- 
mand prompts. The input strings are what we typed 
into the program, and the output strings are the 
expected reversed text. 

As you can see, the application properly logged 
everything that was coming in and going out. Now, if 
we had a problem with the code (such as an occa- 
sional too-short output string), we could consult the 
log to look at what the user entered, and figure out 
why it didn't work in the debugger. 

Design by Contract 

The final technique that we will look at for use in the 
debugging of C++ applications is actually one that you 
build in at the initial coding time, although you can 
add it after the fact. This technique — called Design 
by Contract — was primarily created by the Eiffel 
programming language. In the Design by Contract 
(DBC) methodology, there are three important parts 
of any piece of code: 

Preconditions: These are conditions you take for 
granted before you can proceed with a process. 
For example, if you are trying to read from a file, 
it is important that the file be open first. If you 
are reading bytes from the file, and it is open, 
then you must specify a positive number of 
bytes, because reading a negative number of 
bytes makes no sense and could therefore lead to 
problems. Specifying a positive number of bytes, 
therefore, is a precondition for the process. A 
precondition is simply an assumption that you 
have made while you are coding the process. 
By documenting these assumptions in the code 
itself, you make life easier for the user of the 
code, as well as for the maintainer of the code. 

i>* Validity checks: These are simply "sanity 
checks" for your object. For example, your 
object might contain a value that represents a 
person's age. If that age value is negative, bad 
things are going to happen when you try to com- 
pute that person's year of birth. This should 
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never happen, of course, but it could happen due 
to programming errors, memory overwrites, or 
^rsistent storage errors. By checking the validity 
: that you work with it, you 
is always in a known state. 



Dgrsistent storage error 

Dropraafe 



Post-conditions: These are conditions that must 
be logically true after your process has completed. 
For example, if you are setting the length of a 
buffer in an object, the post-condition ensures 
that the length is zero or a positive number. 
(Negative lengths make no sense and indicate 
an immediate processing error.) Another good 
example: A post-condition can check an assump- 
tion that a file has been opened — and valid val- 
ues read in — at the end of a given process. If the 
file is not open, or there are no valid values in the 
output list, you know that something you didn't 
anticipate happened during processing. For this 
reason, you check these assumptions in the post- 
condition block of your process. 

The purpose of Design by Contract is to eliminate 
the source of errors before they crop up, which 
streamlines the development process by making 
error checking easier and debugging less intrusive. 
This will save you a lot of time in the long-run by 
making your programs more robust up front. 



Listing 63-4: The Design by Contract Example 




Documentation is a valuable asset in under- 
standing code, but it does nothing to fix prob- 
lems encountered while running the code. If 
you document the assumptions that your code 
makes while you're writing it, you not only 
save those assumptions in one place, but also 
remind yourself to make the code check for 
those assumptions at run-time. 



So how does it all work? Most DBC (Design by 
Contract) process controls are implemented via C++ 
macros. The following steps show you how this 
could be implemented in your own application: 

In the code editor of your choice, create a new 
file to hold the code for the source file of the 
technique. 

In this example, the file is named ch63b . cpp, 
although you can use whatever you choose. This 
file will contain the class definition for your 
automation object. 

2. Type the code in Listing 63-4 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



#include <iostream> 
#i ncl ude <stdl i b . h> 
#include <string.h> 

void abort_program( const char *file, long line , const char *expression) 
{ 

printf ("File: %s Line: %ld Expression Failed: %s\n", file, line, expression); 
exit(l) ; 



class DBCObject 
{ 

long _magicNo; 
publ i c : 

DBCObject( long magic 



jnagicNo = magic; 



(continued) 
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Listing 63-4 (continued) 



#ifdef _DEBUG 

"tual bocJ IsValidt) const = 0; 



l_ ^ BM^'tiiai do oil isva 

DropBaoks 



const 



return _magicNo; 

} 

void setMagicNot long magic ) 

{ 

_magicNo = magic; 



#ifdef _DEBUG 

#define DBC_ASSERT(bool_expression) if ( ! (bool_expression) ) abort_program( FILE , LINE , 

#bool_expressi on ) 
#define IS_VALID(obj ) DBC_ASSERT( ( obj ) != NULL && ( ob j ) -> I s Va 1 i d ( ) ) 
#def i ne REQUIRE(bool_expressi on ) DBC_ASSERT(bool_expressi on ) 
#define ENSURE(bool_expression) DBC_ASSERT(bool_expression) 

#el se 

// When your code is built in release mode, the _DEBUG flag would not be defined, thus there 

will be no overhead 
// in the final release from these checks. 

#define DBC_ASSERf ( ignore) ((void) 1) 

#define IS_VALID(ignore) ((void) 1) 

#define REQUIRE(ignore) ((void) 1) 

#define ENSURE(ignore) ((void) 1) 

#endi f 

class MyClass : public DBCObject 

{ 

private: 

char *_buffer; 

int _bufLen; 
protected : 

void I n i t ( ) 

{ 

_buffer=NULL; 
_bufLen = 0; 



#ifdef _DEBUG 

bool IsVal id( ) const 

{ 

// Condition: Buffer not null, 
if ( getBuffert ) == NULL ) 
return false; 
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II Condition: Length > 0. 
if ( getLengthO <= 0 ) 
return false; 




I LSomli lij 

B 

r eTTTr r 



magic number correct. 
123456 ) 

e ; 



// All conditions are correct, so it's okay to continue, 
return true; 



#endi f 



public: 

MyCl ass ( voi d ) 

: DBCObjectt 123456 ) 

{ 

InitO ; 

) 

MyClasst const char *strln ) 
: DBCObjectt 123456 ) 

{ 

// Precondition: strln not NULL. 
REQUIREt strln != NULL ) ; 



InitO ; 

setBuf f er( strln ) ; 

// Post-condition: buffer not NULL. 
ENSUREt getBufferO != NULL ) ; 
// Post-condition: buffer length not 0. 
ENSURE( getLengthO != 0 ) ; 

I 

MyClasst const MyClass& aCopy ) 
: DBCObjectt 123456 ) 

{ 

// Precondition: aCopy is valid. 
IS_VALID(&aCopy) ; 

// Precondition: aCopy ._buf f er not NULL. 
REQUIREt aCopy .getBufferO != NULL ); 
// Precondition: aCopy ._buf Len not 0. 
REQUIREt aCopy .getLengthO != 0 ); 

// Set the pieces. 
setBuffert aCopy ._buf f er ); 
setLengtht aCopy ._buf Len ); 

// Post-condition: buffer not NULL. 
ENSUREt getBufferO != NULL ) ; 
// Post-condition: buffer length not 0. 
ENSUREt getLengthO != 0 ) ; 

(continued) 
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Listing 63-4 (continued) 
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Jass oper|ptor=( const MyClass& aCopy ) 
aCopy is valid. 

IS_VALID(&aCopy) ; 
// Precondition: aCopy ._buf f er not NULL. 
REQUIREC aCopy.getBufferC ) != NULL ); 
// Precondition: aCopy ._buf Len not 0. 
REQUIRE( aCopy.getLength( ) != 0 ); 



// Set the pieces. 
setBuffer( aCopy ._buf f er ); 
setLength( aCopy ._buf Len ); 



// Post-condition: buffer not NULL. 
ENSUREC getBuffer( ) != NULL ) ; 
// Post-condition: buffer length not 0. 
ENSURE( getLength( ) != 0 ) ; 



// Return the current object, 
return *this; 

} 



vi rtual ~MyCl ass ( ) 

// Precondition: Magic number must be correct. 

REQUIREC MagicO == 123456 ); 5 

// Pre-condition: length >= 0. 

REQUIREC getLengthC ) >= 0 ) ; 

// Pre-condition: If length, buffer NOT NULL. 

if ( getLengthC) ) 

REQUIRE ( getBufferO != NULL ); 

// All looks okay; delete the buffer. 

if ( buffer != NULL ) delete [] Jouffer; 

_buffer = NULL; 
// Clear the length. 
_bufLen = 0; 



// Post-condition: The magic number is still correct. 
ENSUREC MagicO == 123456 ) ; 
// Post-condition: Buffer NULL. 
ENSUREC getBufferO == NULL ); 
// Post-condition: Length 0. 

ENSUREC getLengthC) == 0 ) ; 6 



) 
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void setBuffert const char *strln ) 

{ 

// Precondition: strln not NULL. 




{ 

_buffer = new char[ strl en(strln) + 1 ]; 
strcpy ( _buffer, strln ); 

} 

} 

void setLength ( int length ) 

{ 

// Pre-condition: Length > 0. 
REQUIRE ( length > 0 ) ; 

_bufLen = length; 

} 

int getLength( void ) const 

{ 

// No conditions, 
return _bufLen; 

} 

const char *getBuffer( void ) const 

{ 

// No conditions, 
return _buffer; 

} 



In Listing 63-4, we use the pre- and post-conditions 
to insure that valid values are set in our object at 
all times. Note, for example, in the destructor for 
the class that our precondition is that the magic 
number stored in the class be set to the correct 
values (123456, shown at 5) and that at the end 
of the class the length be zero (shown at -* 6). 
If either of these conditions is false, the program 
prints an error message and exits. 

As you can see, the code does copious checking 
to make sure that the object data is always in a 
consistent state, that the input to the various 
methods is valid, and that the output from the 
object processes is valid as well. In the following 
steps, a very simple test of the code shows 
exactly how this all works. 



3. In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch63b . cpp. 

4. Type the following code into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 

int maintint argc, char **argv ) 
{ 

// Program Conditions. 
REQUIRE ( argc > 1 ) ; 
REQUIRE ( argv[l] != NULL ) ; 
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II Empty object. 
MyClass mcl; 
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MyCl ass mc2( argv[l] ) ; 
// Make a copy of it. 
MyClass mc3 = mc2; 



5. Save the source file in your code editor and 
close the editor application. 

6, Compile the source file with your favorite com- 
piler on your favorite operating system. 

7[ Run the application. 

If you have done everything properly, you 
should see the following output on your com- 
mand console: 

$ ./a.exe 

File: ch8_lc.cpp Line: 204 Expression 
Failed: argc > 1 

Okay, it's fairly obvious what happened here: We 
told the system to check for the number of argu- 
ments to the application, and required that there 
be some arguments, but they weren't there. Let's 
supply one and see what happens. 

$ . /a . exe Hel 1 o 

File: ch8_lc.cpp Line: 99 Expression 
Failed: getLengthO != 0 

Oops! What happened here? We supplied an 
argument — and the code failed anyway. Looking 
at the line that failed, we can see that it was the 
post-condition of the constructor for the class. 
Aha! We never set the length of the buffer in the 
constructor, setting only the buffer itself. Let's 
fix that by adding some to the constructor. 

Q m In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch8_2c . cpp. 



9. Modify the code as follows. Replace the exist- 
ing code in the My CI ass constructor with the 
listing below. 

MyClass( const char *strln ) 
: DBC0bject( 123456 ) 



NULL. 



// Precondition: strln not 
REQU I RE ( strln != NULL ) ; 
Init( ) ; 

setBuffer( strln ) ; 
setLength ( strl en ( strln ) ); 

// Post-condition: buffer not 



NULL. 



ENSURE( getBuffer( ) != NULL ) ; 
// Post-condition: buffer 
length not 0. 

ENSURE( getLengthO != 0 ) ; 

} 

10. Save the source file in your code editor, and 
then close the editor application. 

f f. Compile the source file with your favorite com- 
piler on your favorite operating system. 

12. R un the application. 

If you have done everything properly, you should 
see the following output on your command console: 

$ ./a.exe 



As you can see, there are no errors reported. That 
significant lack means all the contracts in the code 
have been satisfied — and the code should 
encounter no problems when run with the tests 
we've created. 

Of course, to keep this happy arrangement going, 
you have to exercise some care: Every time you 
encounter a problem in the system, make sure that 
you add a test to account for that problem. That is 
the final piece of the Design by Contract method of 
debugging and maintenance. 
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When you are debugging a program, there is nothing quite as frus- 
trating as discovering that all the work you spent tracking down a 
particular problem was wasted because the method you thought 
was being called in a C++ class was, in fact, not the code being executed at 
all. Figuring out which method is being called can be an annoying problem, 
and careful observation is often needed to see what is really happening, 
as we will see in this programming technique. 

An overloaded method is a method that has the same name as another 
method in the same class, but contains a different number or type of 
arguments. (The list of arguments and the return type combine to form a 
signature for the method.) 

When you have a class that contains overloaded methods, it is essential 
that you know which one is being called in each case. Because the num- 
ber of arguments can be the same for different overloaded methods 
(only the type of the arguments is different), it can be difficult to tell 
which method is being called in your application source code. Let's take 
a look at a class that contains overloaded methods with problems. We 
will create a class that contains several overloaded methods in this tech- 
nique, and differentiate them only by the type of argument they accept. 
You will see that it is not always easy to tell which method is being called 
in your program. Here's how: 

f m In the code editor of your choice, create a new file to hold the code 
for the implementation of the source file. 

In this example, the file is named ch64 . cpp, although you can use 
whatever you choose. 

2. Type the code from Listing 64-1 into your file. 



Or better yet, copy the code from the source file on this book's 
companion Web site. 
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Listing 64-1: Class with Overloaded Methods 

#include <iostream> 
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class MyClass 
) 

i n t _x ; 
publ i c : 

MyCl ass ( voi d ) 



_x = 0; 
MyClassd'nt x) 
_x = x ; 

MyClasst const MyClass& aCopy ) 

_x = aCopy._x; 

MyClass operator=( i nt x) 

setX(x) ; 
return *this; 

MyClass operator=(doubl e d) 

setX(d) ; 
return *this; 

MyClass operator=( const char *str ) 

setX ( str ) ; 
return *this; 

oid setX( int x ) 

_x = x ; 
oid setX( double d ) 

_x = ( i n t ) d ; 
oid setX( const char *str ) 

int x = atoi ( str ) ; 
nt getX(void) 

return _x ; 



void print(MyCl ass& mc) 

{ 

cout << "Dump : " << endl ; 

cout << " " << 

endl ; 

cout << "X = " << mc.getXO << endl; 

cout << " " << 

endl ; 



int maind'nt argc, char **argv) 
1 

MyCl ass mc(3) ; 
print(mc) ; 
mc = 2.0; 
print(mc) ; 
mc = 5 ; 
print(mc) ; 
mc = "6.34" ; 
print(mc) ; 



The class shown in our little test program above 
has three methods that have the same name, 
setX. These methods take three different types 
of arguments: The first method, shown at -* 1, 
takes an integer value; the second method, shown 
at -» 2, takes a floating point (double) value; the 
final version of the method takes a string as its 
argument, as shown at -» 3. In addition, the func- 
tion has three overloaded assignment operators 
(operator=, shown at lines -> 4, -* 5, and -» 6). 
The test driver assigns an object of the My C 1 a s s 
type some various values, 2.0, 5, and "6.34". 
You would expect that the result of the output 
in the print statements would be the values 
assigned at each stage. As we will see, however, 
the last assignment statement (shown at -> 7) 
does not work properly. Take a moment and look 
at the code and see if you can figure out why. 

3. Save the source code in your source-code editor 
and close the source-code editor application. 

4. Compile the source code with your favorite 
compiler on your favorite operating system. 

5. Run the resulting program on your favorite 
operating system. 



}; 



Adding Logging to the Application 



If you have done everything right, you should see 
the following output in the console window of your 
favorit 



favoriteuiperating system: 

DropEooRs 

I DumD : 



I Dump 
X = 3 
Dump : 
X = 2 
Dump : 
X = 5 
Dump : 
X = 5 



Now, something here is obviously not right. We 
assigned the values to be 3, 2, 5, and 6.34. We should 
not be seeing the values of 5 in the last two positions. 
The third position is correct because that was the 
value assigned just before that print statement. But 
the fourth position follows an assignment to the 
string value "6.34". After that is assigned, the value 
should no longer be 5. So what is going on here? 

If we tracked through the code to see what's going on, 
we'd eventually discover that the problem is in the 
assignment operator that accepts a string. However, 
tracing something this specific could take quite a 
while, because there are numerous ways that this 
particular bit of code could have been accessed. It's 
relatively easy to spot the incorrect value when you 
are looking at the output from the program in this 
form, because we know what the expected output 
is and we have a limited number of lines. Imagine, 
however, having to ransack hundreds of output state- 
ments and thousands of lines of code — not nearly so 
easy. So how do we make this task easier to debug? 

The next section shows you how. 



Adding Loqqinq to 
the Application 



To fix this problem, the best way to handle overloaded 
methods is to note problems as we encounter them. 
To do so, we can add some specialized logging to our 
application to track down which method is failing — 
and what's going on. The following steps do that: 

Reopen the source file for this technique. 



In this example, I called the source file ch64 . cpp. 

2, Change the MyCl ass definition from its existing 
form to the code shown in Listing 64-2. 


Listing 64-2: The Modified MyClass 


Listing 


#define LOG(x) (cout << (x 


) << endl ) 


class MyClass 
{ 




int _x; 
publ i c : 

MyCl ass ( voi d ) 

{ 




setX(O) ; 

LOG ("Null Const 
to 0" ) ; 


ructor: Setting _x 



MyCl ass (int x) 
setX(x) ; 

LOG ("Int Constructor: Setting _x 
to x" ) ; 

MyClasst const MyClass& aCopy ) 
setXtaCopy ._x) ; 

LOG ("Copy Constructor: Setting _x 
to x " ) ; 

MyClass operator=( i nt x) 

L0G( "Assi gnment Operator int"); 
LOG(x) ; 
setX(x) ; 
return *this; 



(continued) 
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Listing 64-2 (continued) 



MyClass operator=(doubl e d ) 

ment Operator double"); 
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setX(d) ; 
return *this; 

MyClass operator=( const char *str ) 

L0G( "Assi gnment Operator str"); -* 8 
LOG(str); 9 
setX( str ) ; 
return *this; 

void setX( int x ) 

L0G( "setX doubl e" ) ; 
_x = x ; 
L0G(_x) ; 

void setX( double d ) 

L0G( "setX doubl e" ) ; 
_x = ( i n t ) d ; 
L0G(_x) ; 

void setX( const char *str ) 

LOGC'setX str"); 
int x = atoi(str); 
L0G(_x) ; 

nt getX(void) 

return _x ; 



The code above is substantially the same as the 
original listing, but it now contains logging state- 
ments that can be used in a debug environment 
to output details about what is going on in the 
program. As you can see, we have added a LOG 
statement to each of the methods, so that we 
are printing out each call and change within the 
code. For example, in the operator- method that 
accepts a string argument, we have added lines 
-* 8 and -» 9, logging the name of the method 
and the value we are changing. Let's see what 



good this does for us in determining the source 
of the problem. 

3. Compile the source file with your favorite com- 
piler, on your favorite operating system. 

4. Run the resulting program on your favorite 
operating system. 

If you have done everything right, you should see the 
following output from the program on the console 
window: 

$ ./a.exe 
setX double 
3 

Int Constructor: Setting _x to x 
Dump : 



X = 3 

Assignment Operator double 

2 

setX double 
2 

setX double 

2 

Copy Constructor: Setting _x to x 
Dump : 



X = 2 

Assignment Operator int 
5 

setX double 
5 

setX double 
5 

Copy Constructor: Setting _x to x 
Dump: 



X = 5 



Assignment Operator str 
6.34 

setX str 
5 

setX double 

5 

Copy Constructor: Setting _x to x 
Dump : 



10 



X = 5 
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Now, looking at the output from this code makes it 
pretty obvious where the problem lies — but we can 
do onejapre thing ^o make it even more obvious. We 

X functions to verify that 
is what we really get. We 
haven't fixed anything yet, but we now know that 
the reason the value isn't being set is because the 
operator- that accepts a string is sending the proper 
value to the setx that accepts a string, but the value 
is not being changed (as shown at -* 10 in the out- 
put listing above). The assert will tell us exactly 
when the value is not changed. 

Suppose we modified the setx that accepted a string 
to read like this: 

void setX( const char *str ) 
{ 

LOGC'setX str"); 

i nt x = atoi ( str ) ; -* 11 

L0G(_x) ; 

assert( _x == x ) ; 



This modification adds a post-condition to the setx 
method that asserts that the value of the variable x 
is equal to the value of the variable x. 



Wait a minute — we're expecting the output to be 
the same as the integer value of the string that was 
input — correct? In this case, the code would fail 
because the output is not correct; we'd have our cul- 
prit. The combination of logging and asserts — built 
into the overloaded methods — makes the problem 
easy to find. It also points out a serious problem 
with overloaded methods: They complicate debug- 
ging and maintenance. After we recognize that the 
problem is a local variable assigned in the method 
instead of the class member variable x, we can fix 
the problem by removing the local x variable shown 
at -> 11 above. 



You don't have to use the features of the lan- 
guage just because they exist. Sometimes it's 
better not to. 



The program will work properly now. What you've 
seen in this technique is how to trace through the 
overloaded methods in a class, logging information 
and assuring that the values coming out of the 
method are what you expect them to be. 
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The final stage in any development process is to optimize the code 
to make it run better, faster, and more efficiently. Of course, in an 
ideal world, you would be optimizing the code as you went along, 
but for most applications this simply isn't possible. Instead, developers 
first get all of the functionality in place, test it, and then optimize it. This 
technique explores some methods you can use in the post-development 
phase to optimize your code. While it will never beat developing opti- 
mized code in the first place, post-development optimization can still 
identify and fix many bottlenecks in the code, and give a boost to code 
that runs just a little too slow. 



Making Functions Inline 



The first optimization technique that you can use is to make your func- 
tions inline code versions. Inline functions and methods are those that 
are defined at the same time they are implemented, in the class header. 
An inline function can be considerably faster than its non-inline brethren, 
but that speed comes at a cost. Inline functions make your program big- 
ger, and can sometimes even make it slower, because they add overhead 
to the code. An inline function is expanded in place wherever it is called, 
much like a macro. This can cause the code to grow significantly, 
because there are many copies of the same code in the program. It could 
slow loading and executing of the program down, if there are enough of 
the copies to make the program very large in size. However, in many 
cases, you can speed up your code significantly by making accessor func- 
tions inline. The reason is that the compiler can optimize the code in 
place, so that procedures that use inline functions are more optimal than 
they would be with regular function calls. Accessor functions, which pro- 
vide read and write access to individual data members, are excellent tar- 
gets for inlining because they are very small and can be optimized 
readily. 
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Take a look at the following class: 

class Foo 

Dro^goeks 

Foo(const char *str) 
{ 

_str = str; 

} 

string getStri ng( voi d ) ; 

); 

string Foo: :getString(void) 
{ 

return _str; 

} 
} 

We can improve the efficiency of this method by 
inlining the method, like this: 

string getStri ng( voi d ) 
{ 

return str; 



m 



Although many modern compilers do this 
optimization for you automatically, it's always 
up to you to write the best possible code. 
Don't rely on the compiler to fix it up. 



The rules for inlining are very simple: 

Always inline a simple accessor. 

Never inline a large method, as the amount of 
code added to your program far outweighs the 
savings from the inline. 

Inline only when the savings from the function 
overhead are small compared to the overall sav- 
ings. In other words, inlining functions that call 
other functions is generally wasteful. 



Avoiding Temporary Objects 

If there is a single optimization technique that you 
should most seriously look at in C++, it's to avoid 
having to create and delete temporary objects. 
Every time you pass an object by value, you make a 
temporary copy of that object. Every time that you 
write code that casts a basic data type to an object, 
you create a temporary object. If you want to opti- 
mize your code, look through it and remove all tem- 
porary object creations. Let's take a look at an 
example of code that really overdoes it with tempo- 
raries, to get an idea of what the problem really is. 

In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch65 . cpp, 
although you can use whatever you choose. 

2, Type the code from Listing 65-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 65-1: Temporary Objects 

#include <iostream> 
#include <stdlib.h> 
#include <time.h> 

using namespace std; 

class Integer 
I 

int _iVal ; 
publ i c : 

Integer( ) 

{ 

cout << "Void constructor" << endl 
_iVal = 0; 

} 

Integer( int iVal ) 

{ 
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cout << "Normal constructor" << 
endl ; 



iVal = iVal 
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nteger& aCopy 



cout << "Copy constructor" << endl ; 
_i Val = aCopy ._i Val ; 

Integer ( ) 

cout << "Destructor" << endl ; 
nt getlntO const 

return _i Val ; 
void setlntdnt iVal ) 

_iVal = i Val ; 

nteger operator+= ( const Integers il 

setlntC il.getlntO + getlntO ); 
return *this; 



Integer operator+( const Integers il, const 
Integers i 2 ) 3 

{ 

Integer out ; -» 1 

out.setlntt il.getlntO + i2. getlntO ); 
return out ; -* 2 



Integer operator-( const Integer& il, const 
Integers i2 ) 4 

{ 

return Integert il.getlntO - 
i2. getlntO ); 



int main (void) 
{ 

Integer 11(5), 12(3); 

Integer i3; 

cout << "Test plus: " << endl; 

i3 = il + i2; 

cout << "Result: " << i3. getlntO << 
endl ; 

cout << "Test minus: " << endl; 

Integer i4 = i3 - i2; 

cout << "Result: " << i4. getlntO << 
endl ; 

cout << "Calling function" << endl; 
f unc ( i 4 ) ; 



If we look at the operator+ function that works 
with the Integer class, you will see that the func- 
tion accepts two Integer objects by reference. 
No objects are created here. However, within the 
object, we create a temporary object that is cre- 
ated locally (see -* 1). This object is then used 
to set the pieces of the integer from the two 
Integer objects passed into the function, before 
being returned to the calling program at -* 2. 
The result is then assigned to the result variable 
in the main program (see -> 3). How many tem- 
porary objects are being created here? Let's run 
the program and find out. 

,3. Save the source file in the code editor and then 
close the editor application. 

4, Compile the source-code file with your favorite 
compiler on your favorite operating system. 

5, Run the program on the console window of 
your favorite operating system. 



void func( Integer il ) 



cout << "Integer Value: " << il.getlntO 
<< endl ; 
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If you have done everything correctly, you should 
see the following output on the console window: 




jojn p 1 y t>n|nruj 

Tlormar const rucf or" 
Void constructor 
Test plus: 
Void constructor 
Destructor 
Result: 8 
Test minus: 
Normal constructor 
Result: 5 
Calling function 
Copy constructor 
Integer Value: 5 
Destructor 
Destructor 
Destructor 
Destructor 
Destructor 

The output shows each time an Integer object is 
being created and destroyed. Take a look at the 
pri nt statements, especially those between the Test 
plus: statement and the Test minus: statement. 
There is a temporary object created here, and then 
destroyed. 

Look at the difference between the addition operator 
(shown in Listing 65-1 at the line marked -* 3) and 
the subtraction operator (shown in Listing 65-1 at 
the line marked -> 4); notice that the addition opera- 
tor has some overhead: a void constructor and a 
destructor call. The subtraction call, on the other 
hand, has no such constructor call. The only con- 
struction is the object in the main function that is 
being created to hold the result. How does this hap- 
pen? The answer is, the compiler is optimized to 
understand that a returned object that is assigned 
can be created in the actual space that was allo- 
cated. Because the compiler can optimize an object 
that is constructed in a return statement, and just 



"copy" the memory into the object the result is 
assigned to, it will save you a lot of time and over- 
head if you use this optimization. Also notice that 
if you pass an object by value, rather than by 
reference — as we do in the tunc function — a copy 
is made of the object and the various constructors 
and destructors called. If you are going to pass an 
object into a function, always pass it by reference. 
If you do not plan to change the object within that 
function, pass a constant reference. 



Passing Objects by Reference 

One of the problems with C++ is that not all of it can 
be implemented within any single class. That means 
you either end up with stand-alone functions or 
other objects that must receive objects in their 
methods. For example, consider what happens when 
you pass a stream to a function to output data: 

int pri nt_my_data ( ostream& out) 



out << "Dump of my data" << endl 
// Code to dump the data 



} 



In this simple example, we are passing a stream 
object to a function. Note that the stream is passed 
by reference, using the ampersand, rather than by 
value, which would make a copy of the object. Why 
do we do it this way? Well, suppose you tried to 
write the code another way, such as this: 

int pri nt_my_data ( ostream out ) 
{ 

cout << "Dump of my data" << endl; 

} 

int main( ) 
{ 

pri nt_my_data ( cout ); 
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You would get a compile error, because the ostream 
class copy constructor is private. Creating a private 
constructor is one way to avoid having copies made 

ier one is to pass the 
voids the overhead of a 
temporary object, avoids the call to the copy con- 
structor and destructor, and avoids the problems 
with having objects that are modified in the function. 
Let's look at an example of what I am talking about 
here. 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 



In this exampl 


e, the file is named ch65a . cpp, 


although you < 


:an use whatever you choose. 


2. Type the code 


from Listing 65-2 into your file. 


Or better yet, 


copy the code from the source file 


on this book's 


companion Web site. 


Listing 65-2: Passing 


3Y Reference 


^include <iostr 


eam> 


^include <stdli 


b.h> 


#include <time. 


h> 


using namespace 


std ; 


class Integer 




{ 

int _iVal ; 




public: 




Integer( ) 





cout << "Void constructor" << endl 
_iVal = 0; 

} 

Integert int iVal ) 
{ 

cout << "Normal constructor" << 

endl ; 
_iVal = iVal ; 

} 

Integert const Integer& aCopy ) 

f 

cout << "Copy constructor" << endl 
_i Val = aCopy ._i Val ; 



~Integer( ) 
{ 

cout << "Destructor" << endl ; 

} 

int getlntO const 
{ 

return _i Val ; 

} 

voi d setlnt( i nt i Val ) 



} 


_iVa 


mid funcK 


il 


setln 


'oid func2( 


12 


setln 


nt ma 


n() 


In 


:eger 


f u 


icl(i ) 


CO 


Jt << 


i -g 


3tlnt( 


f u 


ic2(i ) 



cout << "After func2, value 
i . getlnt( ) << endl ; 



" << 



" << 



The two functions in this listing both attempt to 
change the value of the integer value stored in an 
object passed to them. In the first case (shown at 
-* 5), the object is passed by value (the entire 
object is copied before sending it to the func- 
tion). In the second case (shown at -* 6), the 
object is passed by reference (the address of the 
object is passed to the function). You would nor- 
mally expect the two functions to have the same 
result because they do the same thing. As we will 
see when we run the program, however, the two 
have very different ending results. 

3. Save the source file in the code editor and then 
close the editor application. 
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4. Compile the source code file with your favorite 
compiler on your favorite operating system. 




(Hj^(itp{p^n} 



the console window of 
ng system. 

If you have done everything correctly, you 
should see the following output on the console 
window: 

$ ./a.exe 
Void constructor 
Copy constructor 
Destructor 

After fund, value = 0 -> 7 

After func2 , val ue = 12 8 
Destructor 

This code shows that passing a value by refer- 
ence avoids the overhead of creating a tempo- 
rary object. More importantly, this approach 
avoids the problem of making changes that 
aren't reflected in the original object. Notice that 
the fund function does not change the value of 
the integer variable (shown at -* 7 in the out- 
put). This is because the function accepts its 
argument by value, which makes a copy of the 
original object and modifies that copy, rather 
than the object itself. The f unc2 function, shown 
at -*■ 8 in the output, passes its object by refer- 
ence, which means that the original object is 
modified, and the result is reflected in the calling 
routine. 



Postponing Variable 
Declarations 

If you have ever programmed in a language other 
than C++, you are probably already used to the 
process of defining a variable before you use it. This 
was the way to program in C, FORTRAN, and BASIC, 
so most programmers kept that approach when they 
moved to the object-oriented C++ language. Doing so 
is a mistake, however, because it creates potentially 
unnecessary overhead in the code. 



For example, consider the following function: 

int fund char *ptr ) 
{ 

char *newPtr = new char[200]; 

if ( ptr == NULL ) 

{ 

delete newPtr; 
return -1; 



// Do something with the newPtr 
vari abl e 



return 0; 



The code shows no reason to initialize or define the 
newPtr variable before we check the input. If this was 
some class variable that was too large to instantiate 
efficiently, you'd be wasting a lot of time and mem- 
ory by defining this variable without knowing 
whether you'd be using it. 

In general, here are the steps you should always fol- 
low to optimize the instantiation of variables in a 
function or method: 

First, do any input data validation. 

If the data requires that you exit the function, do 
so before you create any variables locally. 

2, Pass the data to existing classes as appropriate. 

If the data you are using must be passed into a 
constructor or other method of a class, break the 
constructor for that class into two parts, valida- 
tion and initialization. 

For example, consider the following code for a 
class that tries to open a file: 

int open_the_fi 1 e(const char *strName) 
{ 

// See whether the input character 

string is valid, 
if (strName==NULL || strName[0]==0) 

return -1; 
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II This will ch 

Drop Bootes 

return -1 • 



// Construct the object. 
fileHandle f h(strName) ; 
// This will check to see if the 
exi sts . 
m J.) ) 

return -1; 
// Now, we can do the "expensive" 

operation oT 
// opening and reading the file, 
if ( fh.OpenO == false ) 

return -1; 
// Read the file. . . 



In this example, we first check all input for 
validity. If it isn't valid, there is no cost to the 
fileHandle object being created. If the input is 
valid, we then pass the validation onto that 
object. First, we simply set the filename into the 
object and see whether that file exists. Then we 
try to open the file — which will buffer the data 
for it and do the overhead (that is, getting the 
operating system to open the file). Only then, if 
all those things work, do we actually read the file, 
which costs the most time. 



Choosing Initialization 
Instead of Assignment 

The final optimization technique to look at is initial- 
izing data (rather than assigning data in construc- 
tors for classes). Under normal circumstances, the 
member data for a class is first constructed (using 
default constructors), and then assigned values 
based on input to the constructor (or defaults pro- 
vided by the programmer). The problem with this 
approach is that the initialization is really done 
twice — first in the constructor and then in the 
assignment. This is wasteful, and leads to program 
slowdowns. 



To see how to make this improvement, follow these 
steps: 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
the source file. 

In this example, the file is named ch65b . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 65-3 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 65-3: Initializing versus Assigning 


#include <iostream> 
#include <string> 




using namespace std; 




class Point 
I 




private: 

int _x; 

int _y; 
publ i c : 

Poi nt ( voi d ) 




( 

cout << "Point: vo 
cal 1 ed" << endl ; 


id constructor 


x = 0; 
_y = 0; 

) 




Pointt int x, int y ) 
{ 




cout << "Point: fu 
cal 1 ed" << endl ; 
_x = x ; 

_y = y; 

} 


11 constructor 


Pointt const Point& p 


) 



cout << "Point: copy constructor 
cal 1 ed" << endl ; 

(continued) 
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Listing 65-3 (continued) 



return _p2; 



x = p . _x ; 
y = P-|_y: 



DropBooKs 



const Points p ) 



cout << "Point: operator- called" << 

endl ; 
_x = p . _x ; 

_y = p-_y; 

return *this; 
nt& X( ) 

return _x ; 
nt& Y( ) 

return _y ; 



class Line 

{ 

Poi nt _pl ; 
Point _p2; 
publ i c : 

Line (void) 



ine( int xl, int x2, int yl, 
int y2 ) 

: _pl(xl,yl), 
_p2(x2,y2) 



>9 
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ine( const Point& pi, const Point &p2 ) 



_pl 
_P2 



pi; 
P2; 



oint& TopLeft( ) 
return _pl ; 



int mai n ( ) 



// First, create some points. 
Point pl(0,0) ; 
Point p2(10,10) ; 

// Now create some lines, 
cout << "Line 1: " << endl; 
Line IK 0,0, 10, 10) ; 
cout << "Line 2: " << endl; 
Line 12( pi, p2 ); 



In this case, we are using a very simple set of 
classes that implement a point and a line. Notice 
that in the Li ne class, there are two separate 
constructors. One takes four data values, indicat- 
ing the starting and ending x and y coordinates 
(see -» 9). The second takes two point objects to 
define the same coordinates, as shown in -* 10. 
The difference in the two constructors is how the 
data is assigned to the internal member variables 
in the two cases. In the first case, the two points 
in the Line class are initialized within the initial- 
ization line of the constructor code. In the sec- 
ond case, the two points are initialized by 
assignment within the constructor body. As we 
will see when the program runs, these two 
choices have very different results. 

3. Save the source file in the code editor and then 
close the editor application. 

4. Compile the source-code file with your favorite 
compiler on your favorite operating system. 

5. Run the program on the console window of 
your favorite operating system. 
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If you have done everything correctly, you should 
see the following output on the console window: 

J rO f^rrj^ul)l(c^rfC5^or called 

|poim^fuTl constructor called 
Li ne 1 : -* 

Point: full constructor called 
Point: full constructor called 
Line 2: 

Point: void constructor called 
Point: void constructor called 
Point: operator= called 
Point: operator= called 



Notice that in the first case (shown at -* 11), we con- 
struct the two points as a part of constructing the 
line. This is as expected because the Li ne object 
contains two point objects. However, those two 
objects are constructed using the full constructor 
11 for the Poi nt class, using the data values we passed 
in. This means there is no additional overhead for 
creating the points. In the second case, shown at 
-* 12, however, we not only have the two Point 
objects being created, but also the overhead of two 
assignment statements. This means that twice as 
much work is being done. If you initialize things 
using the initialization process in C++ constructors, 
you avoid the overhead of the assignments. 
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Beginning programmers are often afraid to make adjustments to 
existing code for fear of destroying the code's functionality. 
Existing code is simply part of life in the programming world, and 
you can't be afraid to just dig in and make changes to the code base. 
Other than to offer simple encouragement, I can't really give you any 
advice on how to work with existing code; however, I can give you ideas 
on how to make your code easier to work with. 

If you want to save a lot of time for yourself and all of the programmers 
who come after you, document the flow of data through the system. Most 
programmers document how the code works, or how you interface to the 
objects in the system. This is a nice thing, but the problems that crop up 
in coding are normally related to data, not code. In this technique, we are 
going to explore the most important part of the programming system, the 
data flow. 



Learning HouJ Code Operates 

If you really want to know how the code in a system operates, just watch 
how it manipulates data. The surest way to do so is to keep track of all 
changes in a system. Although we normally think of an object-oriented 
system as having member variables and methods to access those vari- 
ables, there is really no reason to do things this way. We can simply 
implement a system that stores the data in properties and then accesses 
those properties through standard methods of the property manipula- 
tion class rather than through the parent class. The following steps show 
you this exact process, implementing a property holding class and pro- 
viding methods to track the changes to the data as it goes through the 
system. 
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f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
^source filg 

i t e id p^^^ile is named ch66 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 66-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 66-1: Implementing Properties As a Class 

#i include <map> 

#i include <string> 

#i include <iostream> 

^include <stack> 

^include <stdlib.h> 

using namespace std; 

class State 



publ 



string _name; 
string _value; 
i c : 

State( voi d ) 

_name = " " ; 
_val ue = " " ; 

State( const char *name, const char 
*value ) 

setNamet name ) ; 
setVal ue( value ) ; 

Statet const State& aCopy ) 

setNamet aCopy . getNamet ) ); 
setValuet aCopy . getVal ue( ) ); 

void setNamet const char *n ) 

_name = n; 

void setNamet const string& n ) 



_name = n; 
string getNametvoid) const 

return _name; 
void setValuet const char *v ) 

_value = v; 
void setValuet const string& v ) 

_value = v; 
string getValuet void ) const 

return _value; 

); 

class Properties 
{ 

map<string, string> _props; 
stack<State> _previous; 

publ i c : 

Properti es ( voi d ) 



Propertiest const Properties& aCopy ) 
{ 

map<string, stri ng> : : i terator iter; 
for ( iter = _props . begi n ( ) ; iter != 
_props . endt ) ; ++iter ) 

_props[ (*n'ter) .first ] = 
(*i ter ) . second ; 

I 

virtual ~Properti es ( ) 



void setPropertyt const char *name, int 
value ) 

{ 

// First, see if its there 
if ( _props . f i nd( name ) != 
_props . endt ) ) 

{ 

State soldtname, _props [name] . 
c_str() ); -*3 
(continued) 
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Listing 66-1 (continued) 



_previ ous . push ( sold ); 
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State solcKname, ""); 
_previ ous . push ( sold ); 

} 

char szBuffer[20] ; 

spri ntf ( szBuf f er , "%d", value ); 

_props[name] = szBuffer; 

} 

string getPropertyt const char *name ) 

{ 

return _props[ name ]; 



// Pop off the last change 
State s = _previ ous . top( ) ; 
_previ ous . pop( ) ; 

// Apply it 

_props[s.getName( )] = s. 
getVal ue( ) ; 



) 



Here, because we're tracking all changes to the 
object anyway, undoing one of those changes is 
trivial. Adding this sort of code to the system at 
the outset — rather than trying to build it in 
later — makes for a very robust system that's 
also easy to debug. 

4. Save the source code in your code editor. 



Okay, there's nothing particularly special about 
this code — it simply allows you to add new 
properties to an object, modify them as you see 
fit, and retrieve them. It also keeps track of all of 
the changes to a given object, which would allow 
you to log those changes, or even implement an 
undo system. To give you an idea of how simple 
it would be to add functionality to a system 
based on this object, the next step adds an 
undo method for the Properti es object. The 
Properti es class, shown at -* 1, keeps track of a 
list of properties for other objects. Within the 
class, the State class (shown at -* 2) is used to 
maintain a list of the various values for each 
property. When a value is changed, a new State 
object is created with the old value and stored 
(see —> 3). This will allow us to implement undo 
very simply. 

3. Add the following code to the class listing: 

void undo() 

{ 

if ( _previ ous . empty ( ) ) 
return ; 



Testing the Properties Class 

After you create a class, you should create a test 
driver that not only ensures your code is correct, 
but also shows people how to use your code. The 
following steps tell you how: 

/. In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 
ch66 . cpp. 

2. Type the code from Listing 66-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 66-2: The Property Test Program 

i nt mai n ( ) 

{ 

Properties p; 

p . setProperty ( "x", 12 ); -* 4 

cout << "x = " << p . getProperty 
( "x" ) .c_str( ) << endl ; 



Testing the Properties Class 



p . setProperty ( "x", 13 ); 
cout << "x = " << 

p . getProDerty ( "x" ) . c_str ( ) << endl ; 




If you have done everything properly, you should 
see the following output from the program on the 
console window: 



p . getProperty ( "x" ) . c_str ( ) << endl; 



$ ./a.exe 

x = 12 
x = 13 
x = 12 



The test program simply creates a Properties 
object and adds a new property called x to it 
(shown at -> 4). We print out the value of that 
property, then change it -* 5. The value is then 
printed out again to verify the change. At this 
point, we undo the last change for the Properties 
object by using the undo method at -* 6. We would 
then expect the value of x to be its previous 
value, 12, rather than the current value of 13. 

3. Save the source code in the source-code editor 
and close the editor application. 

4. Compile the source code with your favorite 
compiler on your favorite operating system. 

5. Run the program on your favorite operating 
system console. 



As we expected, the value of x changes from the last 
set value, 13, to its previous setting of 12 due to the 
undo function call. The undo functionality, besides 
being useful in a program by itself, also shows you 
how to track changes to data within the program. 
This ability will make it very simple to debug appli- 
cations by seeing exactly how things changed over 
time. 

As you can see, the system properly stores the infor- 
mation for the properties and easily implements the 
undo system. This type of object could easily be 
dropped into a "regular" object to replace the entire 
member variable list. 




Tracking and documenting the data flow 
within an application is the single most impor- 
tant thing you can do for programmers, main- 
tained, debuggers, and customer support 



personnel. Data flow is what the user cares 
about and the QA department uses to validate 
your system. By making it easy to see what 
changes and when it happens, you save your- 
self immense amounts of time later on in the 
development process. 
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From time to time, programmers must "lock out" the functionality of a 
given application. There are many possible reasons for this neces- 
sity: If you're running a multithreaded application, for example, you 
need to keep multiple threads from hitting the same function at the same 
time. Or perhaps you're writing an application in which a resource (such 
as a hardware device) can be accessed only at certain times. 

"Locking" a program means denying the program access into a given 
block of code until a certain condition occurs. Not unlike a finite-state 
machine, a lock mechanism can force a system into certain transitions 
(movements from one state to another) only when they are ready to 
happen — which ensures a predictable outcome and avoids unforeseen 
circumstances. Locking mechanisms save time for the developer by 
reducing hard to reproduce errors and problems that can only be tested 
in multi-user environments. 

There are many ways to implement locking in an application. Most oper- 
ating systems provide heavyweight critical-section handlers that can be 
used to lock only small pieces of code at the hardware level. These mech- 
anisms, however, are intended only for serious multithreading; they impose 
too much overhead in terms of processing time, memory required, and 
code required, for the average application to utilize. What is really needed 
is a more lightweight system — with little or no overhead — that you can 
use to lock global resources within your application code at run-time. 
Filling that need is the purpose of this technique. 



T 



Portability is one big advantage of implementing and employing your 
own locking mechanism instead of a system-level lock. Using your 
own locking mechanism allows your code to port easily from system 
to system without requiring extensive rewrites (often necessary when 
you use a new compiler or operating system). Even if you choose to 
use the underlying system support to lock your application, you 
should wrap that functionality in your own class so it's the only place 
you have to make changes when you move to a new operating sys- 
tem, compiler, or version of the library code. 



Creating the Locking Mechanism 



Creating the Locking 




zing your code the appropriate locking functional- 
ity is pretty straightforward. The following steps 
show how to create a class that does the job: 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
source file. 

In this example, the file is named ch67 . cpp, 
although you can use whatever you choose. 

2. Type the code in Listing 67-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 67-1: The Simple Locking-Mechanism Class 

#include <string> 
#include <vector> 



using namespace std; 

class LockExcepti on 

{ 

string _msg; 
public: 

LockExcepti on ( voi d ) 

{ 

_msg = "Lock Exception"; 

} 

LockExcepti on ( const char *msg ) 

{ 

_msg = "Lock Exception: "; 
_msg += msg; 

} 

LockExcepti on ( const LockExcepti on& 
aCopy ) 

{ 

_msg = aCopy ._msg ; 

} 

const char *Message ( voi d ) 

{ 

return _msg . c_str ( ) ; 

} 

void setMessaget const char *msg ) 



_msg = msg; 

) 

) ; 

class Lock 
{ 

private: 

static bool _bLock; 

bool _isLocked; 
publ i c : 

Lock(void) 

_isLocked = false; 
Lock( const Lock& aCopy ) 

_isLocked = aCopy ._i s Locked ; 
virtual ~Lock() 

unLockt ) ; 

bool setLockt) 

if ( !_is Locked ) 
{ 

i f ( _bLock == false ) 
I 

_bLock = true; 
return true; 

I 

I 

return false; 

} 

bool i s Locked ( voi d ) 
{ 

return _bLock; 

I 

void unLockt void ) 
{ 

if ( _is Locked ) 
{ 

if ( _bLock == true ) 
{ 

_bLock = false; 



bool Lock : :_bLock=f al se ; 
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The above listing consists of two classes: the 
Lock class, which implements the actual locking 
mech anism, and the LockExcepti on class, which 
i|ai^imntMrlQK(jMtion holder for any locking 

Jn^^bfkV^^ 5 works by maintaining a 
single global variable (bLock, shown at -* 1) that 
is used to see whether or not the lock is active. 
All instances of the Lock class use the same vari- 
able to track their locking states, so the Lock 
class is really useful only for a single lock in your 
application. The Lock class just checks to see 
whether or not the variable is set; if so, it will not 
allow another lock to be implemented. The 
destructor clears the lock (shown at line marked 
2) so that a lock cannot be maintained indefi- 
nitely. Alternatively, the user can set and clear 
the lock manually, by using the setLock and 
unLock methods. 

You will notice that the code uses a single static 
Boolean data member (shown at line marked 
with -* 2) to maintain its state. This is necessary 
because the Lock class must be accessible 
across different objects; otherwise the entire 
purpose of the class is defeated. Using static 



Listing 67-2: The Lock Test Driver 



data members is not always a good idea — doing 
so makes inheritance from the base class harder 
to implement — but such an approach can also 
solve some pretty thorny problems. 

3. Save the source file and close the code editor. 



Testing the Locking Mechanism 

In order to illustrate how the locking code works and 
why it works, you should create a test driver that 
shows how to use the code and what the expected 
results will be. The following steps show you how. 

f m In the code editor of your choice, reopen 
the existing file to hold the code for your test 
program. 

In this example, I named the test program 

ch67 . cpp. 

2, Type the code from Listing 67-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Lock gLock; 



void funcK) 



Lock 11; 



if ( 1 1. is Locked () ) 

throw LockExcepti on ( "Unabl e to acquire lock\n"); 

else 

printfC'Able to acquire lock\n"); 



void func2() 



i f ( gLock . i s Locked( ) 
gLock. setLockt ) ; 

else 

gLock. unLockt ) ; 



false ) 



Testing the Locking Mechanism 



int maind'nt argc, char **argv) 

{ 

if ( argc < 2 ) 
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^ge: ch7_7 [ lock | unlock ]\n"); 
"Were: lock indicates that the program should first set the global lock and\n" 
printf(" unlock indicates that the program should not first set the global 

1 o c k \ n " ) ; 



if ( Istrcmp ( argv[l], "unlock" ) ) 



// Note that in this order, the two functions will work properly. 

try 

{ 

fund ( ) ; 

} 

catch ( LockExcepti on& exc ) 
{ 

pri ntf ( "unl ock : Exception trying to lock: %s\n", exc.Messaget ) ); 

} 

func2( ) ; 

} 

else 

if ( Istrcmp ( argv[l], "lock" ) ) 



! 



func2( ) ; 
try 



fund ( ) ; 
) 

catch ( LockExcepti on& exc ) 
{ 

pri ntf ( " 1 ock : Exception trying to lock: %s\n", exc.Message( ) ); 



else 

pri ntf ( "Unknown argument %s\n", argv[l] ): 



return 0; 
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The test driver code simply exercises the various 
locking functions. If you pass in a command line 
argument, it will either lock (pass in 1 ock) or 

jk) the global lock object. If 
id cannot be granted, it 
throws an exception that should be displayed on 
the console. 
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3. Save the source file in the code editor and close 
the editor application. 

4. Compile and link the application on your 
favorite operating system, using your compiler 
of choice. 

If you have done everything right, you should see the 
following output appear on your shell window: 

$ ./a.exe 

Usage: ch7_7 [ lock | unlock ] 

Where: lock indicates that the program 

should first set the global lock and 
unlock indicates that the program 

should not first set the global lock 

$ . /a . exe 1 ock -* 5 

lock: Exception trying to lock: Lock 
Exception: Unable to acquire lock 

$ . /a . exe unl ock -* 6 

Able to acquire lock 

Note that the three possible scenarios for running 
the program are shown in the output: 



\^ If you invoke the program with no arguments, it 
prints out the usage of the program and exits. 

If you attempt to set the lock, the program first 
sets a lock (as shown at -» 3) and then sets a 
local lock within a function (shown at -> 4). 
Because the global lock is still in operation, the 
lock in f unc2 fails and throws an exception. 

If you run the program to unlock, it succeeds as 
expected and prints out the fact that it could 
acquire a lock. 

In the first run of the program (the 1 ock case, shown 
at the line marked -* 5), we have first locked the 
global lock in the function f unc2. This causes the call 
to fund to fail, because it cannot get access to the 
lock. 

In the second run of the program (shown at the line 
marked ~* 6), we call the fund function first so the 
program can get the lock and continue. The lock 
object goes out of scope and releases the lock before 
the second function (f unc2) is called — so f unc2 can 
also get access to the lock and successfully proceed. 



This code illustrates another use of the static 
data member in C++, besides the typical use 
of keeping track of data within a class. Used 
properly, static data members can be used to 
communicate between functions, methods, or 
instances of objects — even across thread 
boundaries. 
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A guardian class, as its name implies, is a class that "guards" its con- 
tents from the world of application developers. Guardian classes 
are often used when memory is being allocated, or when a hard- 
ware device needs to have specific inputs validated for it. Because a 
memory allocation needs to be matched with a de-allocation, a guardian 
class is the ideal solution: it wraps the transaction in a single class. 
Guardian classes, as shown in this technique, can also be used to make 
existing functionality memory-safe, exception-safe, and (most impor- 
tantly) error-proof. 

Consider, for a moment, the standard C-style function f open. This function 
is used with the C library to open a file for input, output, or both. The 
f open function has the following prototype: 

FILE *fopen( 

const char *filename, 
const char *mode 

The basic idea is that you pass in a file name and a "mode" parameter, 
and the function opens the file in any operating system. The function 
then returns to you a pointer to an internal structure used for working 
with the file. At this point, you can perform basic file operations: You can 
write to, read from, seek within, and close the file as needed. 

Although they are not the least bit object-oriented in design, you can use 
the f open and related functions safely in your C++ code. Unfortunately, C- 
style functions do not tend to have a great deal of error checking, nor are 
they forgiving. If f open fails, it returns a NULL pointer. If you then pass 
this NULL pointer to another function expecting a FILE pointer, it crashes 
the application. This is where guardian classes work best. In terms of 
code stability and robustness, however, consider the following snippets 
of code: 
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(1) FILE *fp = fopen(NULL, NULL); 1 

(2) FILE *fp = fopenCmyfile.txt", 
"z"); -+2 

r fAOer\ ( "myf i 1 e . txt " , 



isci test") ; 

fcl ose(fp) ; 
(4) FILE *fp = fopenCmyfile.txt", 

"w"); ->4 
try { 

cal l_a_f uncti on_that_mi ght_throw_excep- 
ti ons ( ) ; 

} 

catch ( . . . ) 
{ 

pri ntf( " Error in f uncti on\n ") ; 
return -1; 

} 

fcl ose(fp) ; 

All these functions suffer from various — and 
serious — problems related to the file-handling 
functions provided with C: 

*>* Example (1 shown at -* 1 crashes. The f open 
function does not understand how to deal with 
NULL values in either the name or the mode 
parameter. 

v* In example (2) shown at -* 2, the mode parameter 
may not be z. Mode parameters are well defined, 
and must be one of a certain list of characters. 
Typically, the list is r, w, and a. The behavior in 
such a case is unknown — and will probably 
result in the file not being opened. 

j*** Example (3), shown at -* 3, is a crash waiting to 
happen: Because the programmer did not check 
for the return value from f open, the f pri ntf func- 
tion call will crash — and so will the program — 
if the file pointer is NULL . 

v* Example (4), shown at -> 4 has a serious problem: 
If the function call for cal l_a_f uncti on_that_ 
mi ght_throw_excepti ons throws an exception, 
then the function will return without closing the 
file — creating a memory leak and leaving a file 
open (both on disk and in memory). At best, the 
open file will not be written properly to disk; at 
worst, it might be partially written and corrupted. 




All these problems can — and should — be prevented. 
There is no excuse for allowing a simple file-open 
routine to cause your program to crash. Because the 
file-handling functions are so fragile, you should 
wrap them in a guardian class to ensure that the pro- 
grammer cannot make mistakes, that no memory is 
leaked, and that the functions are protected from 
invalid values. This technique shows you how to set 
up this essential safeguard. 



Whenever you run across a piece of code that 
is unsafe to use in any manner other than the 
way specified by the programmer, wrapping 
that code in a guardian class will save you a lot 
of time trying to track down problems. If the 
program simply crashes with no diagnostics, 
you have to step through every single line in 
the application to figure out what went wrong. 
If (instead) you get into the habit of wrapping 
any would-be leaks or crashes in a code that 
insulates the underlying technology from the 
possibility of error, you won't see this kind of 
error in your application. 



Creating the Fi(e-Guardian 
Class 

The heart of this technique is the creation of a file- 
guardian class called Fi 1 eWrapper. To create it, fol- 
low these steps: 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
source file. 

In this example, the file is named ch68 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 68-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 
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Listing 68-1: The Guardian-Class Source Code 

^include <stdio.h> 
l_ ^ #it|al^de <striig.h> 

DropBooks 

Read = 0, 
Write = 1, 
ReadWrite = 2, 
Append = 3 
I FileMode; 

class FileWrapper 
{ 

FILE *_fp; 
char *_name; 
FileMode _mode; 

vi rtual voi d Ini t( ) 
{ 

_fp = NULL; 
_name = NULL; 

} 

vi rtual voi d CI ear( ) 
{ 

if ( _fp ) 

1 

printf("File %s is now closed\n", _name ); 
fcl ose(_fp) ; 
_fp = NULL; 

} 

if ( _name ) 

delete [] _name; 
_name = NULL; 

> 

publ i c : 

Fi 1 eWrapper ( void) 
{ 

Ini t( ) ; 

} 

FileWrapper( const char *name, const FileMode& mode ) 
{ 

Ini t( ) ; 

setName( name ) ; 
setMode( mode ) ; 

} 

FileWrapper( const FileWrapper& aCopy ) 




(continued) 
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name ) 

lslW^ie( aCopy._name ); 
if ( aCopy ._mode ) 

setMode( aCopy._mode ); 

} 

FileWrapper operator=( const FileWrapper& aCopy) 
{ 

Clear( ) ; 

if ( aCopy._name ) 

setName( aCopy._name ); 
if ( aCopy._mode ) 

setMode( aCopy._mode ); 

) 

virtual ~Fi 1 eWrapper( void ) 
{ 

Clear( ) ; 

) 

virtual void setName( const char *name ) 
{ 

if ( name ) 
{ 

_name = new char[ strl en ( name )+l ]; 
strcpy( _name, name ); 

) 

} 

virtual void setMode( const FileMode& mode ) 
{ 

_mode = mode; 



virtual bool open() -> 6 

if ( _fp != NULL ) 
{ 

f cl ose(_fp) ; 
_fp = NULL; 

) 

char *mode = NULL; 
switch ( _mode ) 
{ 

case Read: 

mode = "r"; 

break; 
case Write: 

mode = "w" ; 

break; 
case ReadWrite: 

mode = " r+" ; 

break; 
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case Append: 
mode = ' 
break; 



DropBobfe 



NULL 
n false; 



_fp = fopen( _name, mode ); 
if ( !_fp ) 

{ 

printft "Error opening file %s\n", _name 
return false; 

} 

printft "File %s is now open\n", _name ); 

} 

virtual char getcO 
{ 

if ( _fp != NULL ) 

return f getc (_f p ) ; 
return 0; 

} 

virtual bool eof() 
{ 

if ( _fp != NULL ) 

return f eof (_f p) ; 
return true; 

} 

virtual bool putc( char c ) 
{ 

if ( _fp != NULL ) 

return fputctc, _fp) == c; 
return false; 

} 

virtual bool puts( const char *s ) 
{ 

if ( _fp == NULL ) 

return false; 
if ( s == NULL ) 

return false; 
return (fputst s, _fp ) != EOF ); 

} 



virtual bool closet) 
{ 

if ( _fp == NULL ) 
return false; 
ClearO; 
return true; 
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BThe puts functior 

Tf th^» flip ic nr\t nnpn r 



The code above doesn't really do anything that 
the standard C functions don't already do for 
. The putsjunction, for example, does 

method (shown at -* 5) 
)e very important difference. 
If the file is not open, or the string is NULL, the 
puts method in the class above checks for the 
error and returns an error code. The puts func- 
tion, on the other hand, crashes the application 
if either of those conditions is true. 

Note also the open function, shown at the line 
marked -» 6. The mode problem cannot exist in 
this class, as it did in the f open function, 
because we pass in an enumerated value that 
must be one of a list of valid values. If it is not, an 
error occurs. 

3. Save the source code in the code editor. 

Note that we have replaced the problematic "mode" 
parameter of the open class with a safer, more secure 
enumeration that we can validate. Also notice that 
all the various read and write functions (shown at 
lines -* 7 and -* 8) work, whether or not the file was 
successfully opened. 



Testing the Fite-Guardian Class 

After you create a class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 
The following steps tell you how: 

In the code editor of your choice, reopen 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch68 . cpp. 

2. Type the code from Listing 68-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 68-2: The File-Guardian Test Program 

i nt f unc2( ) 
{ 

throw "Thi s i s bad ! " ; 

) 

i nt ol d_f unc( ) 
{ 

FILE *fp = f open ( "anol dfi 1 e . out " , 
if ( fp == NULL ) 
return -1; 



" w " ) ; 



f pri ntf ( f p , 
try 



"Thi s is s test\n " ) ; 



func2( ) ; 

) 

catch (...) 



printf("An error occurred\n" ) ; 
return -2: 



pri ntf ( "CI osi ng file\n"); 
fcl ose(fp) ; 
return 0; 



i nt new_f unc( ) 
f 



FileW rapper out( "anewf i 1 e . out'' 
if ( out.openO == false ) 
return -1; 

out . puts ( "Thi s is a test\n"); 
try 



Wri te ) ; 



func2( : 



) 



catch ( 
{ 

printf("An error occurred\n " ) ; 
return -2; 



out . cl ose( ) ; 
return 0; 
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int mainCint argc, char **argv) 

{ 

if ( argc < 2 ) 

iage: ch7_9 f i 1 ename\n " ) ; 
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FileWrapper fw(argv[l], Write); 

// Note that we do not check the 

resul ts . 
fw . open ( ) ; 

// Write out all the arguments. 



for ( int 
{ 

fw . pu 

} 


i=2; i<argc; ++i ) 

ts ( argv[i ] ) ; 10 


// Note th 


at we don ' t call cl ose . 


// Now tes 
ol d_f unc( ) 
new_f unc( ) 


t the various functions. 


return 0; 

) 




The test driver simply opens an output file 



(shown at -* 9 in Listing 68-2), writes out any 
arguments from the command line to the file 
(shown at -* 10) and then finishes. In addition, it 
uses two functions to illustrate how the old-style 
and new-style functions are used. If you look at 
the output, you will see that when the exception 
is thrown the new-style file routines properly 
close the file, whereas the old-style functions do 
not. This is an important difference, especially if 
you are writing to a file throughout your applica- 
tion as in the case of a log file. 

3. Save the source code in the code editor and 
then close the editor application. 



4. Compile the source code with your favorite 
compiler, on your favorite operating system. 

5, Run the program on your favorite operating 
system's console. 

If you have done everything properly, you should 
see the following output from the program on the 
console window: 

$ ./a.exe test. out this is a test of the 

emergency broadcast system 
File test, out is now open 
An error occurred 
File anewfile.out is now open 
An error occurred 
File anewfile.out is now closed 
File test. out is now closed 

As you can see, the new file was properly closed, as 
was the test. out file. These files were both created 
via the new functionality. The old-style file, however, 
was never closed, because the exception was thrown 
and the f cl ose statement was never executed. 

You should also see two files created in your file sys- 
tem, anewf i 1 e . out and anol df i 1 e . out. If you look at 
the contents of the files, you should see the following. 



$ cat anewfile 
This is a test 



out 



$cat anol df i 1 e . out 

The anewf i 1 e . out file has the text we expected. The 
anol df i 1 d . out file, on the other hand, is empty. 



ii 



Depending on your operating system and set- 
tings, you may or may not see text in the 
anoldfile.out text file. This uncertainty 
alone makes it worthwhile to close the files. 
Some operating systems flush data as it is 
written to them to the disk. Others keep it in 
memory until the file is closed, or there is 
enough data to write out a full buffer. You do 
not want to rely on the operating system to 
determine this, if the data being written is 
important to you. 
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numbers class 

f Testing your class 



The mathematical world deals with complex numbers all of the time. 
A complex number is simply a combination of a "real" number (that 
is, a floating-point value), and an "imaginary" number (i — the 
square root of -1 — or a multiple of i). Complex numbers are usually 
written out in the form x + yi, where x is the real number and y is the mul- 
tiplier of the imaginary number. 

You might not believe it, but some folks think they never need to know 
anything about complex math — and never expect to use a complex num- 
ber in your applications. Okay, complex numbers are rarely used in appli- 
cations — but when they are needed (in scientific projects, for example), 
they can be tricky to work with. Creating a class that deals with these 
numbers in advance of working on such a project is to your advantage. 
Understanding the fundamentals of complex mathematics can be tricky; 
you just need a class that does the work for you so that you don't have to 
think about it. 

If you attempt to become an expert in all the expert subject matter in 
every application you work on, you will quickly find yourself not only 
frustrated, but buried in work. Sometimes it's best just to accept that oth- 
ers know the science or business of the area better than you ever will. In 
such cases, you save a lot of time by finding a good set of classes that do 
the work of the expert subject matter — and then working on the rest of 
the application. It is more important that you have an excellent suite of 
tests to validate your classes than it is that you have the ability to write 
them from the start. Save time and energy, and work on the test suite 
rather than the class. This technique shows you how. 



Implementing the Complex Class 



Implementing the 




>st versions ofthe Standard Template Library have 
a complex template in the <compl ex> header file. 
However, this is not universal — and using this tem- 
plate means loading in the entire STL when you link 
your application. If all you need is a complex-number 
class, you'd be better off creating your own class. 

First, we need to implement the definition of the 
complex number class. The following steps show 
you how. 



f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
source file. 

In this example, the file is named ch69 . cpp, 
although you can use whatever you choose. 

2, Type the code from Listing 69-1 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 69-1: The Complex Class Definition 

//include <math.h> 
//include <stdio.h> 
//include <iostream> 

using namespace std; 

class Complex 

{ 

pri vate : 

doubl e real ; 
double imaginary; 
protected : 

// mathematical functionality 
void add(const Complex &a , const Complex &b); 

void subtract(const Complex &a , const Complex &b); 
void mul ti pi y( const Complex &a , const Complex &b); 

void negative( ) ; 




public: 

Compl ex( ) ; 

Compl extdoubl e realValue, double imaginaryVal ue) ; 
Complext const Complex& aCopy ); 

Complex operator=(const Complex &a); 

// accessor functions 
double magnitudeO const; 

double get_real() const; 
double get_imaginary( ) const; 



}; 
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This listing is simply the class definition. In com- 
plex terms, the x + yi part maps to the real and 
the i maginary Jerms in the code. As you can see, 
tors and accessors to get 
Aginary portions of the com- 
plex number. 



The next step is to do the actual implementation 
of the class. This will not include any external 



operators, because they "live" outside of the 
class definition itself. 

3. Append the code from Listing 69-2 into your 
file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 69-2: The Complex Class Implementation 

// constructors 
Compl ex: :Compl ex( ) 

1 

real = imaginary = 0; 

} 

Compl ex: : Compl ex(doubl e realValue, double imagi nary Val ue ) 

{ 

real = realValue; 
imaginary = imagi nary Val ue; 

} 

// Copy constructor 

Compl ex: :Compl ex( const Complex& aCopy ) 

1 

real = aCopy . real ; 

imaginary = aCopy . imagi nary ; 

} 

// accessor functions 
double Compl ex: :magnitude( ) const 

( 

return sqrt(pow(real ,2) + powd'maginary, 

1 

double Compl ex :: get_real ( ) const 

{ 

return real ; 

} 

double Compl ex :: get_imagi nary ( ) const 

{ 

return imaginary; 

1 




Implementing the Complex Class 



void Compl ex :: add ( const Complex &a, const Complex &b) 



DropB©©ki 



jeal ( ) + b.get_real ( ) ; 
|et_imaginary( ) + b.get_imaginary( ) ; 



void Compl ex :: subtract ( const Complex &a, const Complex &b) 

{ 

real = a.get_real() - b.get_real ( ) ; 
imaginary = a . get_imagi nary ( ) - b.get_imaginary( ) ; 



void Compl ex : :mul ti ply ( const Complex &a, const Complex &b) 

{ 

real = a . get_real ( )*b . get_real ( ) - a . get_imagi nary ( )*b . get_imagi nary ( ) ; 
imaginary = a . get_real ( )*b . get_imagi nary ( ) + a . get_imagi nary ( )*b . get_real ( ] 

} 

void Compl ex :: negati vet ) 

{ 

imaginary = -imaginary; 



// assigns one complex number to another 
Complex Compl ex :: operator=( const Complex &a) 

{ 

real = a . get_real ( ) ; 
imaginary = a . get_imagi nary ( ) ; 

return *this; 



The above listing is the implementation of the 
code that we defined in the class definition. These 
two listings could, and often are, split into two 
files. The class definition is placed in a header 
file, and the class implementation is placed in a 
source file. For simplicity, we are placing them 
all in the same file for this technique. The func- 
tionality for the underlying complex variable 
class is implemented in the add (shown at -> 1), 
subtract (shown at -* 2) and mul ti pi y (shown 
at -* 3) methods that are protected methods of 
the class. This is necessary so that we can over- 
ride the operators +, -, and * later on. 



Finally, we need to implement the utility func- 
tions for this class — in particular, the external 
operators that allow us to override the mathe- 
matical operations, as well as the streaming 
operator that allows us to output a complex 
number simply. These functions are imple- 
mented separately because they are not a part of 
the class itself, but rather they are global func- 
tions that can reside anywhere. 

4. Append the code from Listing 69-3 into your tile. 

Better yet, copy the code from the source file on 
this book's companion Web site. 
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Listing 69-3: The Complex Variable Utility Methods 

Complex operator+( const Complex &a , const Complex &b) 




a . get_imagi nary ( ) + b.get_imaginary( ) ) ; 



Complex operator- ( const Complex &a , const Complex &b) 

{ 

Complex c ( a . get_real ( ) - b.get_real() , a . get_imagi na ry ( ) - b.get_imaginary( ) ) ; 
return c; 

} 

Complex operator*(const Complex &a , const Complex &b) -* 4 

{ 

Complex c ( a . get_real ( )*b . get_real ( ) - a . get_imagi na ry ( )*b . get_imagi nary ( ) , 
a . get_real ( )*b . get_i magi nary ( ) + a . get_i magi nary ( )*b . get_real ( ) ) ; 

return c; 

} 

ostream& operator<<( ostream& out, const Complex& aComplex ) 

{ 

out << aCompl ex . get_real ( ) << "+" << aCompl ex . get_imagi na ry ( ) << "i"; 
return out; 

} 



The operators simply construct new Compl ex 
objects by using the components of the input 
Compl ex object. For example, in the operator* 
code, shown at -* 4, the multiplication result is 
computed by multiplying the two real parts of 
the complex variables input, subtracting the two 
imaginary parts multiplied together, and assign- 
ing the result to the real portion of the returned 
variable. 




If you provide a test suite with your class- 
definition file, application programmers can 
determine right away whether any changes 
they've made to the class have broken things. 
In addition, this arrangement gives the devel- 
oper of the original code a simple way to run 
regression tests (suites of tests which indicate 
whether previous functionality is still working) 
when problems occur. 



Testing the Complex 
Number Class 

After you create a class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also show people how to use your code. 
The following steps tell you how. 



1, In the code editor of your choice, re-open 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch69 . cpp. 

2. Type the code from Listing 69-4 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Testing the Complex Number Class 



Listing 69-4: The Complex-Number Test Program 



int main( int argc, char **argv) 



Drop Basks 



1.0 ); 
I 3.0 ) ; 



Complex c3 = cl + c2 
Complex c4 = cl * c2 
Complex c5 = c2 - cl 



cout << "Cl 

cout << "C2 

cout << "C3 

cout << "C4 

cout << "C5 



« cl « 

<< c2 << 

<< c3 << 

<< c4 << 

<< c5 << 



endl 
endl 
endl 
endl 
endl 



// Output the pieces 

cout << endl ; 

cout << "Real " << "\t" << 

cout << cl . get_real ( ) << 

cout << c2 . get_real ( ) << 

cout << c3 . get_real ( ) << 

cout << c4 . get_real ( ) << 



"Imaginary" << 
'\t" << cl.get_ 
'\t" << c2.get_ 
'\t" << c3.get_ 

\t" << c4.get_ 



endl ; 

magi nary ( ) << endl 

magi nary ( ) << endl 

magi nary ( ) << endl 

magi nary ( ) << endl 



cout << c5 . get_real ( ) << "\t" << c5.get_imaginary( ) << endl 



return 0; 



Listing 69-4 simply exercises the various compo- 
nents of the Compl ex class functionality. We cre- 
ate a few Compl ex objects at the block of lines 
shown starting at -* 5. Our next set of tests exer- 
cises the mathematical operators to add, sub- 
tract and multiply the Compl ex objects, as shown 
in the block of lines starting at -* 6. We then out- 
put the results for each of the objects, using the 
streaming operator (<<) to illustrate how the for- 
matting is done, and check the results. This is 
shown in the block starting at -* 7. Finally, we 
use the accessor routines to print out the real 
and imaginary portions of each object. 

3, Save the source code as a file in the code editor 
and then close the editor application. 

4. Compile the source code with your favorite 
compiler, on your favorite operating system. 

Run the program on your favorite operating 
system's console. 



If you have done everything properly, you should 
see the following output from the program on the 
console window. Note that in this listing C3 is the 
sum of Cl and C2, C4 is the product, and C5 is the 
difference. We should see that reflected in the 
output: 

$ ./a 

Cl 2+1 i 
C2 3+3 i 
C3 5+4 i 
C4 3+9 i 
C5 1+2 i 

Real Imaginary 

2 1 

3 3 
5 4 
3 9 
1 2 
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The components listed above are simply the objects 
from our test driver. Because CI is equal to 2 + li 
and C2 jj^qual to 3 + 3i, we would expect that if we 
~) would get 5 + 4i, which is 
the value of C3 (the sum of 
Cl'and C2). As we expected, we get the results we 
should. Likewise, in the bottom listing of real and 
imaginary, C3 is the third entry and has a real com- 
ponent of 5 and an imaginary component of 4, as 
expected. 

As you can see, the output is what we would expect 
from the Compl ex number class. We can now drop 



this class into our application and use it — because 
it has no real ties to any other classes. 



A class is useful in an inverse proportion to the 
number of other classes it has to include. 
Cumbersome is bad. If you create a class that 
drags in an entire library of functionality just to 
use a single function in that library, people will 
avoid it. If (instead) you create a class that does 
a single task — such as representing complex 
numbers — and have that class stand alone, 
people will tend to use it in their applications. 
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If you go into a bank and ask for a cashier's check, your bank computer 
system will print the check for the appropriate amount; look closely at 
that check and you'll see that it has the entire amount spelled out in 
English. For example, if I got a cashier's check for $1,200.60, the check 
would read One thousand two hundred dollars and sixty cents. This is not 
an unusual use for a software program, and the ability to translate num- 
bers to words can be applied in many different types of applications, 
from education to finance. 

The design of the codesystem that performs this kind of translation is 
very interesting. The process we go through for this is always done the 
same way. We break the number — no matter how large — down into 
hundreds, and then parse the results into English. For example, if you are 
given the number 123,456, you look first at the 123 and append a thou- 
sand to it — resulting in one hundred twenty-three thousand. Further, 
within a block of hundreds, you will always look at numbers from one to 
twenty, then multiples of ten, then multiples of a hundred. For example, 
you will list the numbers from one to nineteen for a given hundred, then 
it is twenty, twenty-one, thirty, thirty-one, and so forth. 

A process that breaks something into smaller pieces — and then assem- 
bles the pieces into larger components — should naturally make you 
think about objects. In this case, you can see that there are objects for 
the one-to-twenty conversion, the twenty-and-up conversion, and the 
hundreds conversion. The thousands conversion is really just a variant 
of the hundreds. All these cases have a common set of things to look at: 



the specific range of the value 
*>* convert that range into a string 



Let's look at an example, because this is all rather confusing to explain 
and much easier to show. If we start with the number 123,456 and want to 
convert it to English, we would do the following: 
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f m First, we break the number down into the highest 
unit, in this case thousands. So, the first part of 
given number produces the number 123, 
~kd. 



aiii^piven number pro< 

DroDoooRs 

2. Next, we split off the h 



4. 



5. 



6. 



Next, we split off the hundreds. So, we have one 
hundred. 

The next step is to look at the tens unit. If this 
number were zero, we would skip it. In this case, 
it is a two, so the number is twenty. An important 
exception here is the number one. In this case, 
we have to apply special English rules (i.e. 
eleven, twelve, thirteen) and skip the ones digit. 
So, because the second digit is a two, we now 
have one hundred twenty. 

Finally, we look at the ones digit. In our case, it is 
a three, so we have one hundred twenty three. 

Append the units from step 1: one hundred twenty 
three thousand. 

Repeat for the next block. If we are under a thou- 
sand, we skip the units part. Put both blocks 
together to produce: one hundred twenty three 
thousand four hundred fifty six. 



From an object-oriented design viewpoint, the process 
shows that its cases have some elements in common 
elements — as well as some elements that are discrete 
for different cases. This suggests that we have a com- 
mon base class, and then derived classes that manage 
those discrete elements. Furthermore, we can build 
some of the elements from the base classes to create 
new extended classes, such as when we create thou- 
sands from ones and tens. 

This technique shows you how to convert numbers 
into written English. 



Always take a step back from the problem 
when you are trying to do an object-oriented 
design. Doing so gives you the opportunity to 
see the problem from a big-picture perspec- 
tive, which often allows you to break it down 
into small components much more easily. 
When you see all the pieces, you can also usu- 
ally see the overlap between them — which 
can be factored into your base classes. 




You can save a lot of time in the long-run by 
getting the design right from the beginning. 
Understanding how all the pieces fit together 
is essential to getting that design right. 



Creating the Conversion Code 

The first step toward implementing the system is to 
create the base classes used to build the application. 
The following steps show you how. The base classes 
represent the number ranges we are going to use to 
parse the existing number into digits and convert 
those digits into words. 

f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
source file. 

In this example, the file is named ch70 . cpp, 
although you can use whatever you choose. 

2. Type the code from Listing 70-1 into your file. 

Or better yet, copy the code from the source file 
on this book's companion Web site. 



Listing 70-1: The Conversion Base Classes: Source Code 

#include <vector> 
#include <string> 
^include <iostream> 



using namespace std; 

class RangeEntry 
{ 

1 ong _1 Mi n ; 
1 ong _1 Max ; 
1 ong _1 Increment ; 
publ i c : 

RangeEntry(void) 



JMin = 0; 
J Max = 0; 
J Increment 



1 ; 
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} 

RangeEntry ( 1 ong min, long max, long inc=l) 
{ 



RangeEntry ( const RangeEntry& aCopy ) 
{ 

_lMin = aCopy._lMin; 
_lMax = aCopy._lMax; 
_1 Increment = aCopy ._1 Increment ; 

} 

RangeEntry operator=(const RangeEntry& aCopy ) 
{ 

_lMin = aCopy._lMin; 

_lMax = aCopy._lMax; 

_1 Increment = aCopy ._1 Increment ; 

return *this; 

} 

// Accessors 
1 ong Mint) 
{ 

return _lMin; 

} 

long Max() 

return _lMax; 

long Incrementt) 
{ 

return _1 Increment ; 

} 

bool InRange( long IVal) 
{ 

if ( IVal >= Mint) && IVal <= MaxO ) 



return false; 

} 

virtual string getStri ng ( i nt iVal) 
{ 

return "Unknown"; 

} 



class OnesRangeEntry : public RangeEntry 
{ 




return true; 



}; 



(continued) 
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virtual string getStri ng( i nt iVal) 

{ 

switch ( iVal ) 

{ 



case 1: 

return stri ng( "one" ) ; 
case 2: 

return stri ng( "two" ) ; 
case 3: 

return stri ng( "three" ) ; 
case 4: 

return stri ng( "four" ) ; 
case 5: 

return stri ng( "f i ve" ) ; 
case 6: 

return stri ng( "six" ) ; 
case 7: 

return stri ng( " seven" ) ; 
case 8: 

return stri ng( "ei ght" ) ; 
case 9: 

return stri ng( "ni ne" ) ; 
case 10: 

return stri ng( "ten " ) ; 
case 11: 

return stri ng( "el even" ) ; 
case 12: 

return stri ng( "twel ve" ) ; 
case 13: 

return stri ng( "thi rteen" ) ; 
case 14: 

return stri ng( "fourteen" ) ; 
case 15: 

return string( "fifteen" ) ; 
case 16: 

return stri ng( "si xteen" ) ; 
case 17: 

return string( "seventeen" ) ; 
case 18: 

return string( "eighteen" ) ; 
case 19: 

return string( "nineteen" ) ; 



Listing 70-1 (continued) 



pub! ic: 




return stri ng( " " ) ; 
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class TensRangeEntry : public RangeEntry 

{ 

publ i c : 



virtual string getStri ng( i nt iVal) 

{ 

int i Digit = iVal / 10; 
switch ( i Digit ) 

{ 



case 1: 

return stri ng( "ten" ) ; 
case 2: 

return stri ng( "twenty ") ; 
case 3: 

return stri ng( "thi rty " ) ; 
case 4: 

return stri ng( "forty ") ; 
case 5: 

return stringC "fifty" ) ; 
case 6: 

return st ri ng( "si xty " ) ; 
case 7: ^^^^^^ 

return stri ng( "seventy ") ; 
case 8: 

return stri ng( "ei ghty " ) ; 
case 9 : 

return stri ng( "ni nety " ) ; 



class HundredsRangeEntry : public RangeEntry 

{ 

publ i c : 

Hundreds RangeEntry (void) 

: RangeEntrydOO, 1000, 100) 



virtual string getStri ng( i nt iVal) 

{ 

OnesRangeEntry ore; 

int i Digit = iVal / 100; 

string s = ore.getStringt iDigit ); 
s += " hundred" ; 




return stri ng( " " ) ; 



(continued) 
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Listing 70-1 (continued) 



return s; 
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class ThousandsRangeEntry : public RangeEntry 
{ 

publ i c : 

Thousands RangeEntry (void) 

: RangeEntry (1000, 999999, 1000) -* 1 



virtual string getStri ng( i nt iVal) 
{ 

HundredsRangeEntry hre; 
TensRangeEntry tre; 
OnesRangeEntry ore; 

int iDigit = iVal / 1000; 
i nt i Num = iDigit; 
string s = " " ; 

if ( hre . InRange( i Di gi t ) ) -* 2 

{ 

s += hre . getStri ng( iDigit ); 

iDigit = iDigit - (( iDigit/100 ) * 100); 



if ( hre . InRange( i Num) ) 



s += tre . getStri ng( iDigit ); 

iDigit = iDigit - (( iDigit/10 ) * 10); 

) 

if ( ore . getStri ng( iDigit ).length() ) 

s += " " ; 
s += ore . getStri ng( iDigit ); 
s += " thousand"; 

return s; 



These base classes "know" how to convert a sin- 
gle string into a series of words that describe a 
number. However, because there are differences 
for thousands, hundreds, and single digit values, 
we need a set of classes to do each of these. 



any number up to one million. If we wanted to 
parse numbers over one million, of course, we 
would need to add a new class, and so forth for 
each further magnitude we want to handle. 



(digits, hundreds, thousands), we can then parse 



After we have created the three basic ones 



Creating the Conversion Code 




The important thing is how the higher level 
classes (thousand, for example) call the lower 
el classes fliundred, ones) to process the 
'U?^ni<n^)lias.#jkr example, take a look at the 
^Jj^yfrfj^E^^y class. The class contains a 
range value that it processes, numbers between 
1000 and 999999 (shown at -> 1). Within the 
getStri ng method, which converts the number 
into a human readable string, the class then uses 
the hundred, ten, and one digit parsing classes to 
do its work (see lines beginning at -* 2). We 
don't duplicate a lot of code and we don't have 
to go searching through the code to see which 
piece broke when there is an exception. For 
example, if we wanted to properly hyphenate 
output strings (thirty-five, instead of thirty five) 
we would just modify the tens class. 

3. Save the source code in your code editor. 

The next step is to implement the processing 
object that gathers up all the individual conver- 
sions into the output text string. 

4. Reopen the source file in the code editor. 

Append the code from Listing 70-2 to the 
source file. 



NumberToWords ( void ) 
{ 

Initial i zeToDef aul ts ( ) ; 

} 

virtual -NumberToWords ( voi d ) 
{ 

vector< RangeEntry *>::iterator 
iter; 

for ( iter = _entri es . begi n ( ) ; 
iter != _entri es . end( ) ; ++iter ) 
delete (*iter); 

1 

string Convertt int iVal ) 
{ 

string sRet = ""; 

while ( iVal > 0 ) 4 
{ 

bool bFound = false; 

vector< RangeEntry *>::itera- 
tor iter; 

for ( iter = 
_entri es . begi n ( ) ; iter != 
_entri es . end( ) ; ++iter ) 

1 

if ( (*iter)->InRange( 
iVal ) ) 

{ 

if ( sRet.lengthO 



Listing 70-2: The Conversion Class: Source Code 

class NumberToWords 
{ 

pri vate : 

vector< RangeEntry *> _entries; 



protected : 

virtual void Ini ti al i zeToDef aul ts ( ) 
{ 

_entries. insert( _entries.end( ) , 

new OnesRangeEntry ( ) ); -> 3 

_entries.insert( _entries.end(), 

new TensRangeEntry ( ) ); 
_entries.insert( _entries.endC), 

new HundredsRangeEntry ( ) ); 
_entries.insert( _entries.endC), 

new ThousandsRangeEntry ( ) ); 



sRet += " " ; 
sRet += (*iter)- 
>getString( iVal 
) ; 

iVal = iVal - ( 
(IVal / (*iter)- 
>Increment( ) ) * 
(*iter)- 
>Increment( ) ) ; 

bFound = true; 

break; 



if ( ! bFound ) 
iVal = 10; 



return sRet; 



publ i c : 
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The main parts of the NumberToWords class are the 
entries (shown at -* 3 in the Listing 70-2) and the 
lethod. The entries are simply extensions 
— ss that process given 
Converted (the i Val 
parameter). The number is broken down by the 
increment of each range (thousands, hundreds, tens, 
ones) and each entry is called to process that partic- 
ular unit. This continues until the input value is 
reduced to a value of zero. The loop to process the 
value is shown at -* 4. 



Testing the Conversion Code 

After you create a class, you should create a test 
driver that not only ensures that your code is cor- 
rect, but also shows people how to use your code. 
The following steps show you how. 

f m In the code editor of your choice, re-open 
the source file to hold the code for your test 
program. 

In this example, I named the test program 

ch70 . cpp. 

2. Type the code from Listing 70-3 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 70-3: The Number-Conversion Test Program 

int main( ) 



The purpose of our little test driver is simply to show 
that the class works with all of the exceptional cases 
that exist for numeric conversions. For example, we 
want examples of ones, tens, hundreds, and thou- 
sands. We also want a simple example that requires 
the code to check all of its conditions, such as 23. 

3, Save the source code in the code editor and 
then close the editor application. 

4, Compile the source code with your favorite 
compiler, on your favorite operating system. 

5, Run the program on your favorite operating 
system's console. 

If you have done everything properly, you should 
see the following output from the program on the 
console window: 



$ ./a 
Stri ng : 
Stri ng : 
Stri ng : 
Stri ng : 
Stri ng : 



one hundred twenty three 
one 

twenty three 

eight hundred seven 

one hundred twenty three thousand 



four hundred fifty six 

As you can see from the output listing, the code 
works properly. All of the various scenarios are han- 
dled correctly and the output is in expected English. 
As mentioned previously, possible enhancements to 
the application would be extending the classes to 
process millions, billions, and so forth, or adding 
hyphens, if desired. 



NumberToWords nw; 
string si = nw.Convert(123) ; 
cout << "String: " << si << endl 
string s2 = nw. Convert( 1 ) ; 
cout << "String: " << s2 << endl 
string s3 = nw.Convert(23) ; 
cout << "String: " << s3 << endl 
string s4 = nw.Convert(807) ; 
cout << "String: " << s4 << endl 
string s5 = nw.Convert(123456) ; 
cout << "String: " << s5 << endl 
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Programmers know the best program design is always simple. In fact, 
among programmers, the KISS principle has become a cliche: "Keep 
It Simple, Stupid." To keep things simple, you have to follow three 
basic principles when writing and maintaining code: 

Componentizing 
Restructuring 
<>* Specializing 



By following these few simple processes when you develop and debug 
your code, you can drastically cut down on your maintenance time. 
In this technique, we will look at these four pillars of programming 
simplicity — and examine how to apply them. 



A Sample Program 

Imagine, for a moment, that you're working on a program that parses 
input files for words. This sort of program might be used to get a list of 
words for a spell-checker or a stop list for an indexing program. In text 
indexing, a stop list gives the program a list of words to ignore when 
placing them in the index. The code for this type of program is shown in 
Listing 71-1. Its obviously a very simple, stripped-down program, but it 
illustrates the basic idea of what we're trying to accomplish. 
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Listing 71-1: The Original Word-Parser Program 

#include <stdio.h> 

Be < s t r i nc . h > 
oo ks 

ng namespace std; 

void my_func( std::vector< char *>& words ) 

FILE *fp = fopenCmyfile.txt", "r"); 
if ( fp == NULL ) 
return -1; 

while ( ifeof(fp) ) 

{ 

char szBuffer[ 81 ] ; 
memset( szBuffer, 0, 80 ); 
if ( fgets( szBuffer, 80, fp ) == NULL ) 
brea k ; 

// Parse the line 
char szword[80] ; 
memset ( szword, 0, 80 ); 
int pos = 0; 

for ( int i=0; i <( i nt ) strl en ( szBuffer ) ; ++i ) -> 1 

{ 

switch ( szBuffer[i] ) 

{ 

case ' : ' : 

if ( st rl en ( szword ) ) 
{ 

char *str = new cha r[st rl en ( szword )+l ] ; 
strcpy ( str , szword ) ; 
words . i nsert( words. end(), str ); 
szword[0] = 0; 
pos = 0; 

memset ( szword, 0, 80 ); 

I 

brea k ; 
defaul t: 

szWord[pos] = szBuffer[i]; 
pos++; 
brea k ; 

} 

) 

} 



Drop 




fcl ose(fp) 

I 



Componentizing 



int maind'nt argc, char **argv ) 



Drop 



std : : vector< char *> words; 
ffiTfcf uac Laio! 




sTchrvecTOr* chrrr *>::iterator iter; 

for ( iter = words . begi n () ; iter != words. end(); ++iter ) 
pri ntf ( "Word : %s\n", (*iter) ); 



return 0; 



The code above is supposed to read lines in from a 
file, parse them into words, and store the words in 
an array. It is assumed that the lines have a specific 
format: wordl :word2:word3 followed by a carriage 
return. Given an input like that, the assumption is 
that the program will produce a list that contains 
wordl, word2, and word3. The code accomplishes this 
by stepping through each character in the line, look- 
ing for a colon (:) and taking whatever precedes it 
as a word. You can see this code in the loop shown 
at-»1. 

This code generally works, except it has a rather 
severe bug — it will skip words at the end of a line — 
and anyway the real issue is that this code is hard to 
maintain. If we add a new separator to the line (for 
example), what happens? If someone comes along 
and has no idea what the code does, is it at all intu- 
itive? The first step to making things better is to sep- 
arate it into components. 

If we run the program with an input file that looks 
like this 

wordl : word2 : word3 
1 i ne2 : word2 : word3 
1 i ne3 : word3 : word4 

the program will then parse the individual lines into 

Li nel : 

wordl 

word2 



The problem is shown by the fact that the word3 
from line 1 and word3 from line 2 are not shown. 

Componentizing 

Componentizing is my own term for the process of 
splitting something up into components. In our 
code, there are two major components, a file compo- 
nent and a parser component. Components differ 
from functions, methods, or classes. A component is 
a single functional element — that is, a collection of 
code that accomplishes a single task or deals with a 
single area such as a file or parsing text. 
Componentizing simplifies your code by reducing 
the amount of cohesion between the various units of 
a module, and by limiting the areas in which you 
need to search for a given piece of functionality. If 
we are looking for something that reads from or 
writes to a file, we look in the file component. We 
wouldn't bother to look in the parser component, 
because that has nothing to do with reading or writ- 
ing from a file. We have not yet split our class into 
components, we are merely identifying the different 
units in the current code. 

The next step toward making our code simpler is 
to break it down into separate components. Let's 
identify and split out the pieces into their own com- 
ponentized classes. Our new structure will contain 
two separate classes. This is how you do it. 



Line2: 
1 ine2 
word2 
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f m In the code editor of your choice, create a new 
file to hold the code for the implementation of 
ce file. 



4^n^ce rile 
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ile is named ch71 . cpp, 
although you can use whatever you choose. 

2, Type the code from Listing 71-2 into your file. 

Better yet, copy the code from the source file on 
this book's companion Web site. 



Listing 71-2: The Componentized Sample Program 

^include <stdio.h> 
#include <string.h> 
//include <vector> 
#i include <string> 



using namespace std; 

class ParserFile 
{ 

pri vate : 

FILE *fp; 
publ i c : 

ParserFi 1 e( voi d ) 

{ 

fp = NULL; 

} 

ParserFilet const char *fileName ) 

{ 

if ( fileName != NULL ) 

fp = fopent fileName, "r" ); 

} 

stri ng getLi ne( ) 

{ 

string s = " " ; 

if ( fp == NULL ) 
return s; 

char c = 0 ; 

while ( ifeof(fp) && c != '\n' ) 

{ 

c = f getc ( f p ) ; 

if ( c != '\n' && c != '\r' && c 

EOF) 
s += c ; 



return s; 

} 

bool eof ( ) 

{ 

if ( fp == NULL ) 

return true; 
return f eof ( f p ) ; 



class Parser 
1 

pri vate : 

char delimiter; 

vectoK string > words; 
publ i c : 

Parser(void) 

1 

delimiter = ';'; // default 

I 

Parser( const char& delim ) 
1 

del i mi ter = del i m ; 

I 

voi d cl ear( ) 
1 

words. erase( words . begi n () , 
words . end( ) ) ; 



} 

bool parse( const strings in ) 
1 

stri ng sWord = " " ; 

i f ( del i mi ter == 0 ) 

return false; 
if ( in.length( ) == 0 ) 

return false; 

for ( int i=0; i < ( i nt ) i n . 1 ength ( ) ; ++i ) 

{ 

// End of word or string? 

if ( in[i] == delimiter) 

{ 

words . i nsert( words. end(), 

sWord ) ; 
sWord = " " ; 

I 

el se 



Restructuring 



sWord += in[i ] ; 



DropBtocfc 



gthO ) 

words . i nsert( words. end(), sWord ); 



return true; 



) 



i nt num( ) 
{ 

return words . si ze( ) ; 

) 

string word( int idx ) 
{ 

string s = " " ; 
if C idx < 0 || idx > 
( i nt )words . si ze( ) -1 ) 
return s; 
s = words[idx] ; 
return s; 



int mainO'nt argc, char **argv ) 
{ 

ParserFile pf( "myfile.txt" ); 
Parser p( ' : ' ) ; 

while ( Ipf.eofO ) 
{ 

p.cl ear( ) ; 

if (p.parse( pf.getLineO ) == true ) 
{ 

pri ntf ( " Parsed : \n " ) ; 
for ( int i=0; i<p.num(); ++i ) 
pri ntf ( "Word[%d] = %s\n", i, 
p.word(i ) .c_str( ) ) ; 



return 0; 



Note that this code does not do anything different 
from our original code listing. It has simply been 
restructured to be more componentized. The logic 
and functionality remain the same. The code to read 
a file into individual lines has been moved into the 
ParserFi 1 e class (shown at-* 2). This class does 
more error-checking for input, and has specific 
methods to read the file and return individual lines, 
but it is otherwise functionally equivalent to the pre- 
vious example code. Likewise, the Parser class 
(shown at -* 3) still parses a given line, but is no 
longer reliant on any file input to do its work. It is 
now a simple parser class that takes in a string and 
breaks it down into words, using a developer-supplied 
delimiter, in place of our hard-coded colon of the 
first example. 

Looking at the main program, you can see how much 
cleaner the interface is, and how much simpler it is 
to read. It should also be considerably easier to 
debug, because each piece of the code is in a sepa- 
rate component, meaning that when a problem is 
encountered, only that component needs to be 
checked out. 



Restructuring 



Restructuring (also known as refactoring) is the 
process of going back through code and eliminating 
redundancy and duplicated effort. For example, let's 
consider the following snippet of code (not from our 
example, just a generalized piece of code): 

int ret = get_a_l i ne( ) ; 
if ( ret == ERROR ) 

throw "Error in get_a_l i ne ! " ; -* 4 

ret = get_words_f rom_l i net ) ; 
if ( ret == ERROR ) 

throw "Error in get_words_f rom_l i ne ! " ; 
ret = process_words ( ) ; 
if ( ret == ERROR ) 

throw "Error in process_words ! " ; 



Technique 7 1: Reducing the Complexity of Code 



This code is prime territory for refactoring. Why? 
Because the code contains multiple redundant state- 
ments, jj^mely the exception handling (throw lines, 

■ 4) To do this, follow 




7. Examine the code for similar looking state- 
ments or processes. 

In our case, the code that is similar is the check 
for the return code and the throwing of the 
exception string. 

2, Extract the redundant code and factor it into a 
routine of its own. 

In this case, we can factor the code into a single 
routine: 

void CheckAndThrowError( int retCode, 
const char *name ) 



if ( retCode = 
throw name; 



ERROR ) 



3. Replace the existing code with the calls into the 
refactored code. 

CheckAndThrowError( get_a_l i ne( ) , 

"get_a_l i ne" ) ; 
CheckAndThrowError ( get_words_f rom_l i ne( 

) , 

"get_words_f rom_l i ne" ); 
CheckAndThrowError(process_words( ) , 
"process_words" ) ; 

4, If necessary, after the code is refactored, re- 
examine it for other similarities. 

In this example, we might consider logging the 
error within the CheckAndThrowError function. 
This isn't really a refactoring case, but rather an 
observation of what might make the code more 
complete. 



Specialization 



Programmers have a habit of writing code that is 
generalized to the extreme. Why write a routine that 
can break down a string into four parts at particular 



boundaries, when you can write a generalized rou- 
tine that can handle any number of segments — of 
any length each? Sounds great in theory . . . 

One sad lesson — normally learned when debugging 
programs — is that generalization is really a pain in 
the neck. It causes vastly more problems than it 
solves, and it never turns out that your code is gen- 
eral enough to handle every single case that comes 
its way. So you hack the code to make it work; it 
ends up littered with special cases. 

Take a look at an example of generalization and how 
it can get you into trouble. Going back to our original 
code, assume that your input file has very long 
strings in it — not really a valid input file at all. 
Suppose it looked something like this: 

This is a really long sentence that doesn't 
happen to have a colon in it until it 
reaches the very end like this: do you 
think it will work? 

If we run our first example program on this input file, 
it will crash, because we will overwrite the end of 
the word allocated space. This happens because we 
generalized the input to handle any sort of file, 
instead of making it specific to the kind of input we 
were expecting. We could easily change our code to 
handle a bigger string, but instead, we should follow 
the rules of specialization: 

t>* Make sure that input files are clearly marked as 
valid input to the program: In nearly all cases, 
your program-specific input should contain a 
version and type identifier. We haven't added 
this to this simple example, but it would make 
sense to modify the ParserFile class to read in a 
beginning line containing version information. 

If your input is fixed-length, check the length 
before you start loading the data: If you have an 
input file that is supposed to contain words of no 
more than 80 characters, then any time you have 
not encountered a delimiter within 80 charac- 
ters, you should abort the input process and 
print out an error message for the user. If the 
word length is not fixed, then you should never 
use a fixed-length buffer to store it. 



Specialization 



We already fixed this one in the ParserFile class 
by using a string in place of the fixed size buffer. 
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I any format you do not under- 
Is • 1 R k e P^ s a little easier to under- 
fttrnfn example. Let's suppose that you 
are reading in a date from the command line or 
in a graphical user interface. Dates have so many 
formats that it is almost not worth enumerating 
them all. However, if you are given a date that is 
given as 1/1/04, there are numerous ways to 
interpret it. For example, it could be in M/D/YY 
format, and be January 1, 2004. Alternatively, it 
could be in D/M/YY format — which would still 



be January 1, 2004, but would change the inter- 
pretation. There is no reason to keep the ambigu- 
ity. Either force the user to enter in a single 
format, or use a control that specifies the format. 

This one really has no issue in our ParserFile 
class, because we aren't dealing with specific 
data sizes. 

If you follow these guidelines, you will cut down on 
the number of bugs you receive — which makes it 
easier to debug problems that you do encounter in 
your application. 
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overriding operators and, 63 
pre-processor and, 47 
printing using streams, 

226-227 
si zeof function and, 55 
for spreadsheets, 216-222 
static, 209, 211,361 
two-dimensional, 222 
vector algorithms for, 200-203 
vector class (STL) for, 25, 

192-195, 200-203, 209-212, 

226-227 
with and without pointers, 

204-208 
assert macro 

"debug mode" for, 388 
debugging and, 42, 44, 387-389 
error handling with, 44 



for exiting programs, 
avoiding, 43 

never counting on, 389 

not defined in optimized mode, 
387, 389 

output from, 388 

purpose of, 42, 44, 387 

"release mode" and, 388 

run-time and, 42, 389 

testing in optimized environ- 
ment, 44 

turning asserts on and off, 
387-388 

using, 42-43, 388-389 
assignment 

initialization versus, 413-415 

operators, extensibility and, 61 

properties and invalid 
assignments, 136-137 
asterisk (*) 

with Match class, 333 

as wildcard, 330, 333 
auto_ptr class 

benefits of, 303 

copying an auto_ptr, 306 

rules for using, 306 

STL collections and, 306 

testing, 305-306 

using with functions, 303-305 

B 

Bar class, 53, 54 
Base class 

array of object pointers for, 

213-215 
template class, 180-183 
base classes 

array of object pointers for, 

213-215 
for casting examples, 91-92, 94 
common base class for 

abstraction, 18 
conversion into derived class 

by compiler, 24 
for converting numbers to 

words, 440-444 
defined, 12 



factory class, 163-167 
implementing a common base 

class, 162 
for interfaces, 354 
for mailing-list application, 

13-14 

mix-in classes for limiting 

functionality, 168 
object pools of, 162 
pure virtual base classes for 

interfaces, 354 
pure virtual method in, 12 
saving functionality in, 24 
serialization interface, 354-359 
simple template, 176-178 
stepping back from problems 

and, 440 
storing derived objects in an 

array, 213 
using templates as, 179 
virtual destructors for, 22, 25 
for virtual inheritance, 117-119 
for virtual methods, 20 
virtual table for, 21,22 

BaseMai 1 i ngLi stEntry class, 13-14 

Basel and Base2 classes for 
casting, 91-92, 94 

basic types 
defined, 59 
extending, 59-62 

Blowfish encryption algo- 
rithm, 343 

Borland's C++ Builder, 2 

Buffer class (example 1), 308-311 

Buffer class (example 2) 
Buf f erExcepti on class for, 

362, 364 
character arrays versus, 

363-364 
creating, 361-364 
returned value, 364 
static arrays versus, 361 
testing, 364-365 

buffer overflows 

Buffer class for, 361 
defined, 360 
prevalence of, 360 
reasons for not fixing, 361 
security issues, 360, 361 
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Buf f erExcepti on class, 362, 364 
business rules 
defined, 30 
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C++ Builder (Borland), 2 
C++ Timesaving Techniques For 
Dummies (Telles, Matthew) 

companion Web site, 2 

conventions, 2-3 

focus on saving time, 1, 2 

goal of, 1 

icons in margins, 4 

organization, 3-4 

using, 1-3 
C++ versus C 

error handling and, 319 

file-handling functions and, 
425-426 

name resolution and, 85-86 

pointers and, 175 

reusability and, 85 

struct construct and, 74 

structures and, 73-74 
calculation, discrete pieces in 

classes for, 159 
call stack from debuggers, 375 
case 

c_str method for converting, 
349 

implementing the transform 
function to convert strings, 

350- 351 

strup function in C for convert- 
ing, 349 
testing the string conversion, 

351- 353 

casts 

addressing compiler problems, 
93-94 

base classes for, 91-92, 94 
casting away const-ness, 81 
derived classes for, 92, 94 
need for, 90-91 



scoping member functions 
versus, 93-95 

temporary objects and, 408 

test drivers, 93, 95 

testing, 93, 94-95 

using, 91-93 
cDate class 

described, 31 

non-inline methods, 34-35 

source-code listing, 32-34 

testing, 35-36 
chOl through ch71 files. See com- 
panion Web site for this book 
chaining errors, 319-322 
chaining return codes, 328-329 
ChangeManagement class, 115 
character pointers, new operator 

and, 134-135 
checked member variable, 328 
class examples. See also 
examples in this book 

AgeProperty, 139-140 

auto_ptr, 303-306 

Bar, 53, 54 

Basel, for casting examples, 

91-92, 94 
Base2, for casting examples, 

91-92, 94 
BaseMai 1 i ngLi stEntry, 13-14 
Buffer (example 1), 308-311 
Buffer (example 2), 361-365 
cDate, 31-36 
ChangeManagement, 115 
class with methods containing 

default values, 103-106 
Command Li neMai 1 i ngLi stEntry, 

16-17 
Compl ete, 109-115 
Complex, 433-438 
Conf i gurati onFi 1 e 

(example 1), 26-27 
Conf i gurati onFi 1 e 

(example 2), 251 
for converting numbers to 

words, 440-444 
Date, 149-161 
DBCObject, 393-398 
debugFl owf racer, 376-377 



debug Fl owTracerManager, 

377-379 
Del imitedFileParser, 237-238 
Del imitedRow, 236-237 
Del i mi ters, 235-236 
Deri ved, for casting examples, 

92, 94 

Deri ved, for si zeof function 

examples, 52, 54 
Directory Li st, 367-368, 369 
enumeration class, 71-72 
Excepti onCatcher class, 

314- 315,316-317 
Excepti onCl ass, 313-314, 

315- 316,317 
factory class, 163-167 
FileChunk, 284-286 
FileChunkManager, 286-288 
FileHandler, 103-106 
FileMailingListEntry, 14-15 
Fi 1 eW rapper guardian class, 

426-431 
Fruit, 20-22 
Full, 52, 53 

HundredsRangeEntry, 443-444 
Integer, 411-412 
IntProperty, 137-140 
Lock, 421-424 
LockExcepti on, 421-424 
Logger, 389-392 
Match, 331-334 
Matrix, 63-69 
MultiPathFile, 367-371 
for multiple inheritance, 

116-117 
MyAlloc, 298-302 
MyBuffer, 301-302 
MyReturnVal ue, 324-329 
MyString, 122-126 
MyStri ngArray, 196-199 
NoPointer, 205-206 
Number! oWords, 440-446 
OnesRangeEntry, 441-442 
for overloaded methods, 

400-401 
Parser, 450-451 
ParserFi 1 e, 450, 451 
for passing objects by 

reference, 411-412 
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class examples (continued) 
Point, 413-415 
PointgrCl ass, 205-206 
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Properties class for docu- 
menting data flow, 417-419 
Range, 60-62 
RangeEntry, 440-441 
reading delimited files, 235-238 
return code class, 324-329 
RetValue, 324-329 
SavePairs, 25-26, 28-29 
for scope illustration, 83 
SSNVal idator, 142-148 
Stri ngCodi ng, 7-11 
Stri ngConvertTo LowerCase, 

350-353 
StringEntry, 266-268, 271 
StringReader, 273-277 
Stri ngUtil, 252-255, 259 
StringWriter, 268-272 
TensRangeEntry, 443 
TestlntVal lie, 140-141 
ThousandsRangeEntry, 444, 445 
Tracker, 304-306 
Translator, 279-282 
URLCodec, 338-341 
using namespaces, 87-88 
vector (STL), 25, 192-195, 

200-203, 209-212, 226-227 
for virtual files, 283-290 
for virtual inheritance, 117-119 
XMLElement, 241-242 
XMLSuperCl ass, 244, 245 
XMLwriter, 241-245 
XOREncryption, 346-348 
classes. See also class examples; 
templates; specific kinds 
for arrays, with and without 

pointers, 204-208 
base, defined, 12 
breaking into discrete 

pieces, 159 
complete class, 109-115 
for configuration information, 

24-29 
constants in, 79-80 



container classes in the STL, 

179, 200 
for copyright information, 175 
customizing with polymor- 
phism, 20 
customizing with virtual 

functions, 19-22 
for data validation, 142-148 
date class, 149-161 
for encoding strings, 7-11 
enumeration class, 71-72 
as extensions of structure 

component, 73 
external operators for, 61 
factory class, 162 
friend class, 167 
generic buffer class, 360-365 
guardian classes, 425-431 
for implementing properties, 

137-141 
inherited, defined, 12 
initializing versus assigning 

data for, 413-415 
iterating over STL collection 

classes, 292-296 
memory safe buffer class, 

307-311 
with methods containing 

default values, 103-106 
minimizing code for, 31 
mix-in classes, 24-26, 168-171 
multiple inheritance, 23 
name resolution problems in 

libraries, 86 
with overloaded methods, 

400-401 

overloading operators, 120-127 
overriding functionality with 

virtual methods, 162-167 
passing objects by reference, 

410-412 
placing reusable classes in 

namespaces, 89 
properties, 136-141 
return code class, 324-329 
saving functionality in, 24 
scope handled automatically 

for, 82-83 
sections of, 23 



simple template, 176-178 
storing literal string informa- 
tion in, 161 
string array class, 196-199 
struct construct as, 73 
structures versus, 76 
with templated method, 

189-191 
templatizing a single function, 

186-189 
templatizing a single method, 

189-191 
testing, recommendations 

for, 161 
for throwing and logging 

exceptions, 312-317 
to-do list for improvements, 290 
for tracing flow, 376-380 
URLCodec class for, 338-342 
usefulness and number of 

classes included, 438 
virtual inheritance, 116-119 
v-table for virtual methods, 21, 

22,23 

XML structure compared to, 
240-241 
clone method, 109, 113 
code. See also source-code listings 
minimizing for classes, 31 
reducing complexity of, 447-453 
separating rules and data 
from, 30-36 
collections 

algorithms for, 350 
arrays, 291, 292-293 
auto_ptrs in STL collections, 
306 

avoiding assuming contiguous 

order for strings, 349 
benefits of, 291 
constant, 296 

generic STL iterator for, 291 
iterating over STL collection 

classes, 292-296 
iterator needed for, 291 
linked lists, 292, 293 
maps, 292, 293, 295 
non-contiguous elements in, 291 
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overriding the allocator for, 
297-302 

ing items using iterators, 



removing items using it 
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■reverse iteration, 294, 295 
STL and, 291,349 
streams, 294, 296 
swapping elements using 

iterators, 294 
testing iterators, 295-296 
Col umn class for spreadsheet 
creating, 217-218 
methods in, 216, 218 
stored data and, 221 
virtual method in, 217, 218 
comma separated values (CSV) 
files, 234. See also delimited 
files 

command line input, handling, 
12, 13 

command parser, hash table 
for, 279 

command processor class, 99 
command processor class test 

driver, 99 
Command Li neMai 1 i ngLi stEntry 

class, 16-17 
companion Web site for this book 

chl_la . cpp file on, 11 

chOl . cpp file on, 10 

ch02 . cpp file on, 13 

ch02.cpp file on, 17 

ch03 . cpp file on, 20 

ch03 . cpp file on, 21 

ch04.cpp file on, 24 

ch04 . cpp file on, 27 

ch05 . cpp file on, 32 

ch6_12 . cpp file on, 333 

ch06.cpp file on, 40 

ch07 .cpp file on, 42 

ch07 . cpp file on, 44 

ch8_2c . cpp file on, 398 

ch08.cpp file on, 46 

ch09.cpp file on, 49 

chlO.cpp file on, 52 

chll_l . cpp file on, 62 

chll . cpp file on, 60 

chl2.cpp file on, 64, 68 



chl3 . c 
chl4.c 
chl5 . c 
chl6 . c 
chl7 
chl8 
chl9 
ch20 
ch21 
ch22 
ch23 
ch24 
ch25 
ch26 
ch27 
ch27.h 
ch28.c 
ch29 
ch30.c 
ch31a . 
ch31 . c 
ch32.c 
ch33 . c 
ch34.c 
ch35 . c 
ch36 . c 
ch37 . c 
ch38.c 
ch39_4 
ch39.c 
ch40.c 
ch41.c 
ch42.c 
ch43.c 
ch44_6 
ch45_7 
ch45.c 
ch46_l 
ch46a 
ch46.c 
ch47 . c 
ch48 
ch49 
ch50 
ch50 
ch51 
ch52 
ch53 
ch54 



pp file on, 71 

pp file on, 74 

pp file on, 77 

pp file on, 83 

pp file on, 87, 88 

pp file on, 91, 93 

pp file on, 97, 99 

pp file on, 103 

pp file on, 110, 114 

pp file on, 118, 119 

pp file on, 122 

pp file on, 129, 133 

pp file on, 137, 140 

pp file on, 142, 146 

pp file on, 151, 152, 159 

file on, 150 

pp file on, 163, 166 

pp file on, 169 

pp file on, 176 

cpp file on, 184 

pp file on, 180, 183 

pp file on, 186, 189 

pp file on, 192 

pp file on, 196 

pp file on, 201 

pp file on, 204 

ppfile on, 210 

pp file on, 213 

cpp file on, 221 
pp file on, 217 
pp file on, 226 
pp file on, 228, 232 
pp file on, 235, 239 
ppfile on, 241,243 

cpp file on, 246 

cpp file on, 261 
pp file on, 260 

cpp file on, 273 
cpp file on, 277 
pp file on, 266 
pp file on, 280, 281 
pp file on, 284, 289 
pp file on, 292 
pp file on, 300 
file on, 298 
pp file on, 304 
pp file on, 308 
pp file on, 313, 318, 320 
pp file on, 324 



ch55 . cpp fi 
ch56 . cpp fi 
ch57 . cpp fi 
346, 347 
ch58 . cpp fi 
ch59 . cpp fi 
ch59.h file 
ch60 . cpp fi 
c h 6 1 . c p p fi 
ch62a . cpp 
ch62 . cpp fi 
ch63a . cpp 
ch63b . cpp 
ch63 . cpp fi 
ch64 . cpp fi 
ch65a . cpp 
ch65b . cpp 
ch65 . cpp fi 
ch66 . cpp fi 
ch67 . cpp fi 
ch68 . cpp fi 
ch69 . cpp fi 
ch70 . cpp fi 



e on, 331 

e on, 338, 340 

e on, 344, 345, 

e on, 350, 351 
e on, 358 
on, 355 
eon, 361,364 
e on, 367, 369 
ile on, 380 
e on, 376 
ile on, 389, 390 
ile on, 393, 397 
e on, 388 
e on, 398, 401 
ile on, 411 
ile on, 413 
e on, 408 
eon, 417, 418 
eon, 421,422 
e on, 426, 430 
e on, 433, 436 
e on, 440, 446 
e on, 450 

e . cpp file on, 



ch71 . cpp fif 

Conf i gurati onFi " 
251,261 

ConfigurationFile.h header 
file on, 251 

osdef i nes . h header file on, 40 

sizeof program on, 53 

URL for, 2 
comparison operators, 

overriding, 328 
compiler errors and warnings 

addressing immediately, 91 

debugging aided by 
eliminating, 91 

#define versus const state- 
ment and, 46-47 

indicating casting is needed, 93 

Matrix class operators and, 67 

multiple inheritance error, 117 

for namespace problems, 89 
compilers. See also pre-processor 

assert macro and optimized 
mode, 387, 389 

base class/derived class 
conversion by, 24 
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compilers (continued) 

const keyword as indicator to, 

1"^ YT\ f^^ff^f^h^^^ by, 26 
|_y I \J |y|iya^te£|Jlf\iOtite- 

' ment and, 45-47 

examples in this book and, 1, 3 

exception handling and, 322 

GNU C++ compiler, 2 

inheritance implemented by, 

23- 24 

inline functions and, 407, 408 
instantiation for templates 

by, 178 
strup function with strings 

and, 349 
tempi ate keyword and, 178 
typeface in this book for 

output, 2 
types for values passed to 

functions and, 90-91, 93-94 
warning level setting for, 47 
Compl ete class 

creating a template, 110-113 
dirty flag, 110, 114 
need for, 109 
output from, 114 
rules for, 109 

source-code listing, 110-113 

testing, 113-115 
Compl ex class 

defining, 433-434 

implementing, 434-435 

testing, 436-438 

utility functions, 436 
complex numbers 

challenges for expertise in, 432 

defined, 432 

implementing a class for, 
433-436 

template for, 433 

testing the class, 436-438 

uses for, 432 

written form for, 432 
componentizing, 449-451 
configuration files 

basic functionality, 24 

class for storing information, 

24- 29 



configuration-file class 
creation, 251-259 

"endian" concerns for, 250 

finding all files, 367 

as hallmark of professional 
programs, 251 

header file for, 251 

text format for, 250 

typical entry for, 250 
Conf i gurati onFi 1 e class 
(example 1) 

constructor issues for, 27-29 

implementing, 24-26 

Properties class for, 24-25 

SavePai rs class for, 25-26, 
28-29 

source code for, 26 

testing, 27 
Conf i gurati onFi 1 e class 
(example 2) 

defined in header file, 251 

header file for, 251 

read function, 256, 259 

source code for, 251, 256 

storage functions, 259 

StringUtil utility class for, 
252-255, 259 

test file for, 260 

testing, 260-261 
Conf i gurati onFi le.cpp file, 

251-259, 261 
Conf i gurati onFi le.h header 

file, 251 
const iterators, 296 
const keyword 

casting away, 81 

in classes, 79-80 

with Copy constructor, 80 

for differentiating methods, 81 

as indication to compiler, 78-79 

for methods and functions, 77 

versatility of, 80 
const statements 

#def i ne statement compared 
to, 45 

defining constants, 77-78 
implementing constant 
variables, 78-79 



replacing //define values using, 

77-78 
as type-safe, 46 

using instead of #def i ne, 45-47 
constants. See also const key- 
word; const statements 
basic integer variables 

versus, 59 
casting away const-ness, 81 
in classes, 79-80 
collections, 296 
const keyword for, 77, 81 
#define versus const state- 
ment and, 46-47 
defining, 77-78 
for function with immutable 

argument, 78-79 
implementing constant 

variables, 78-80 
returning a const reference, 80 
for SSN length and delimiter, 

143, 146 
testing the constant 

application, 80-81 
uses for, 77 
construct method, overriding, 

299, 300 
constructors 

array of object pointers 

and, 215 
for Compl ete class, 109 
for Conf i gurati onFi 1 e class, 

26, 28-29 
const keyword with Copy 

constructor, 80 
copy constructor for 

auto_ptr, 306 
copy constructor for 

RetVal ue, 329 
default called by compiler, 26 
delayed construction, 27-29 
error handling for, 27-28 
exception types and copy 

constructor, 322 
invoking, 26 
for MyStri ng class, 123 
object pools and, 162 
planning for disasters, 29 
Point class, 414, 415 
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print statements in, for 

debugging, 208 
reqyjffid for Compl ete class, 111 
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'templates and, 178 
two pointers for same memory 

block and, 28 
type and destructor calls, 176 
virtual inheritance and, 119 
container classes (STL). See also 
collections 
algorithms with, 200, 349-350 
creating, 210 

creating arrays of objects 

using, 209-212 
overhead from using, 209-210 
as templates, 179 
transform function for modify- 
ing elements, 349-350 
uses for, 200 
container collections. 

See collections 
control characters, string classes 

and, 348 
conventions in this book, 2-3 
conversion. See also translation 
base class/derived class, by 

compiler, 24 
of case for strings, 349-353 
casts for, 81, 90-95 
c_str method for converting 

case, 349 
hash tables for, 279 
implementing operators for, 122 
implementing the transform 
function to convert strings, 
350-351 
of numbers to words, 439-446 
strup function for converting 

case, 349 
testing the string case conver- 
sion, 351-353 
of types with casts, 90-95 
converting numbers to words 
common set of things to look 

at, 439 
components for, 439 



creating the base classes, 

440- 444 
HundredsRangeEntry class for, 

443-444 
need for, 439 
NumberToWords class for, 

445-446 
OnesRangeEntry class for, 

441- 442 

RangeEntry class for, 440-441 
steps for, 439-440 
f ensRangeEntry class for, 443 
testing the code, 446 
f housandsRangeEntry class for, 
444, 445 
copy constructor 
for auto_ptr, 306 
const keyword with, 80 
exception types and, 322 
for RetVal ue class, 329 
copying 

an auto_ptr, 306 
strings, memory overwrites 
from, 307-308 
copyright information class, 175 
crashing programs 

assert macro and, 43, 44 
from buffer overflows, 360 
C-style file-handling functions 

and, 425-426 
eliminating the source of 

failures, 323 
intentionally, avoiding, 43 
credit card numbers, encryption 

for, 343 
critical-section handlers in 
operating systems, 420 
c_str method, 349 
CSV (comma separated values) 
files, 234. See also delimited 
files 

cumbersomeness, avoiding, 438 
customizing. See also templates 
built-in functions, 102 
classes with polymorphism, 20 
classes with virtual functions, 
19-22 



memory allocation, 297-302 
MessageBox function, 102 
user-defined functions, 103-106 

D 



data. See also input and output 
documenting flow of, 416-419 
encoding and decoding for the 

Web, 337-342 
information-specific, classes 

for handling, 169 
inheriting functionality and, 

23-29 

initializing versus assigning, 
413-415 

protecting from memory over- 
writes, 307-311 

protecting with encapsulation, 
7-11 

separating from code, 30-36 
undo functionality and, 419 

data storage. See also storage 
allocation 
encapsulation benefits for, 1 1 
hash tables for, 279 
literal string information in 

classes, 161 
for matrix in Matri x class, 65 
in XML format, 241-245 

data types. See types 

Date class 

algorithmic code, 153, 154, 159 
basic functionality, 149 
creating the class, 150-152 
defining, 150-151 
enhancements recommended 
for, 161 

implementing date functional- 
ity, 152-159 
initialization code, 152, 159 
need for, 149 
source file, 151-152 
testing, 159-161 
validation code, 153, 159 
date . cpp file, 34 
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dates. See also Date class 
cDate class for, 31-36 



checks scattered Jthroughout a 
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hard-coded, 30 



ard-coded, 30 
IsLeapYear method, 35 
IsVal idDate method, 35 
leap year computations, 30-31 
limitations of standard 

routines for, 149 
portability and, 31 
rejecting confusing formats, 453 
reusability of code and, 30, 31 
DBC methodology. See Design by 

Contract methodology 
DBCObject class 

implementing, 393-397 
testing, 397-398 
deal 1 ocate method 

MyBuf fer class call to, 302 
overriding, 300 
"debug mode" forassert 

macro, 388 
debugFl owTracer class 
creating, 376-377 
debugFl owTracerManager class 

for, 377-379 
testing, 379-380 
debugFl owTracer objects, 385, 386 
debugFl owTracerManager class 
creating, 377-379 
Instance method, 379 
purpose of, 379 
debugging. See also compiler 
errors and warnings; testing; 
tracing 

assert macro definition and, 43 

assert macro for, 42, 44, 
387-389 

avoiding versus fixing prob- 
lems and, 303 

building tracing into applica- 
tions, 375-380 

call stack from debuggers 
and, 375 

categories of techniques 
for, 387 

chaining errors and, 319 



challenges for, 375 
checking size of values 

during, 54 
choosing techniques for, 387 
creating macros and classes 

for, 387-398 
date code and, 31 
debugFl owTracer class for, 

376-377 
debugFl owTracerManager class 

for, 377-379 
Design by Contract for, 392-398 
documenting data flow and, 419 
eliminating compiler warnings 

and, 91 

encapsulation benefits for, 1 1 
failing to handle errors and, 323 
generalization of code and, 452 
inserting tracing into an exist- 
ing file, 380-386 
logging data for, 389-392 
logging errors and, 312 
macro side effects and, 48, 49 
no "right" or "wrong" way 
for, 387 

overloaded methods, 399-403 

overloaded operators and, 121 

physical errors versus logical 
errors and, 31 

print statements in construc- 
tors and destructor for, 208 

separating business rules from 
code and, 31 

specialization and, 452, 453 

system flow and, 375 

testing the flow trace system, 
379-380 

validation and time saved 
in, 142 

decode method, 339-340, 341 
decoding. See also encoding; 
encryption 
decode method, 339-340, 341 
library methods lacking for, 337 
reusable class helpful for, 337 
URLCodec class for, 338-342 
for the Web, 337-342 
when exchanging data with 
Web-based applications, 342 



defaults 

arguments for methods and 

functions, defining, 101-106 
class with methods containing 

default values, 103-106 
constructor called by 

compiler, 26 
#def i ne statements 

const statement compared 

to, 45 

constants for directly replacing 

values, 77-78 
using const instead of, 45-47 
delayed construction, 27-29 
delete operator 
with arrays, 204 
calling correct operator for 

del ete, 135 
handler for, 129-131 
matching up with invocation 

method, 84, 204 
memory allocation problems 

and, 128-129 
output from memory tracking 

program, 133-134 
overloaded handler for, 131-132 
overloading to track memory 

allocation, 129-132 
rules for handler implementa- 
tion, 129 
uses for, 128 
delimited files 

assumptions for examples, 234 
defined, 234 

generic method for reading, 

234-238 
output from reading, 239 
testing the code for reading, 
238-239 
Del i mi tedFi 1 ePa rser class, 

237-238 
Del imitedRow class, 236-237 
Delimiters class, 235-236 
Deri ved class 

array of object pointers for, 

213-215 
for casting examples, 92, 94 
for si zeof function examples, 
52,54 
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derived classes 

array of object pointers for, 



213-215 
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2,94 
ass by 



compiler, 24 
factory pattern and, 162 
for interfaces, 355 
for si zeof function examples, 
52,54 

storing derived objects in an 

array, 213 
test drivers for casting, 93, 95 
virtual destructors for, 22, 25 
virtual methods and, 162 
v-table for, 23 
derived structures, 75, 76 
Design by Contract (DBC) 
methodology 
creation by Eiffel programming 

language, 392 
documenting assumptions 

made by code, 393 
implementing, 393-397 
parts of code according to, 

392-393 
post-conditions for code, 393 
preconditions for code, 

392, 397 
purpose of, 393 
test program for, 397-398 
validity checks for code, 

392-393 
destroy method, overriding, 

299, 300 
destructors. See also virtual 
destructors 
array of object pointers 

and, 215 
arrays of objects and, 211-212 
clearing pointers for exception 

object, 322 
for Compl ete class, 109 
deleting array elements 

and, 204 
object pools and, 162 
planning for disasters, 29 
print statements in, for 

debugging, 208 



required for Compl ete class, 111 
scope and, 82 

storing derived objects in an 
array and, 213 

templates and, 178 

two pointers for same memory 
block and, 28 

type and, 176 

virtual, 22, 25 
diagnostics, dump method and, 278 
dictionary, hash table for, 279 
Di rectoryLi st class 

described, 369 

path delimiter for, 369 

source-code listing, 367-368 
di rty flag 

ChangeManagement class, 115 

Compl ete class, 110, 114 

uses for, 115 
divide-by-zero error, 317-319 
document class, 87-88 
document concept, 86 
documentation 

for assumptions made by 
code, 393 

constants as self- 
documentation, 77 

of data flow, 416-419 

STL, 199 
documenting data flow 

importance of, 419 

learning how code operates, 
416-418 

need for, 416 

Properti es class for, 417-418 
testing the Properties class, 
418-419 

do_xor method, 346, 347 

dump method, 278 



EBCDIC systems, R0T13Encrypti on 

class and, 345 
Eiffel programming language, DBC 

created by, 392 
embedded processors, new in 

pi ace operator and, 135 



encapsulation 

abstraction using, 12 
for algorithms, 7-10, 36 
benefits of, 7-8, 10, 11 
creating and implementing and 

encapsulated class, 7-10 
defined, 7 

encapsulated code as black 
box, 11 

for encryption method, 7-11 
information-specific data 

and, 169 
for Matrix class array row, 64 
protecting data with, 7-11 
reusability and, 30, 31 
for separating rules and data 

from code, 30-36 
in Spreadsheet class, 216 
struct construct as beginning 

of, 73 

type validation and, 142 
updates to an encapsulated 
class, 10-11 
Encode method of Stri ngCodi ng 

class, 9, 10-11 
encode method of URLCodec class, 

339, 340, 341 
encoding. See also decoding; 
encryption 
defined, 337 
Encode method of 

StringCoding class, 9, 10-11 
encode method of URLCodec 

class, 339, 340 
library methods lacking for, 337 
required for special characters 

on the Web, 337 
reusable class helpful for, 337 
URLCodec class for, 338-342 
for the Web, 337-342 
when exchanging data with 
Web-based applications, 342 
encryption. See also encoding 
Blowfish encryption 

algorithm, 343 
defined, 343 

encapsulated method for, 7-10 
encrypting and decrypting 
strings, 343-348 



C++ Timesatfinq Techniques For Dummies 



encryption (continued) 

information requiring, 343 



ncryption algorithm, 
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343 

or text string files, 273 
updating encapsulated 

method, 10-11 
XOR encryption algorithm, 
343, 344-346 
"endian" concerns for configura- 
tion files, 250 
enhancing 

Date class, 161 
keeping a to-do list for 

classes, 290 
manager class, 167 
MultiPathFile class, 371 
virtual file class, 290 
enumerations 
basic form, 70 
defined, 70 

implementing a class for, 71-72 
for readability, 70, 71 
as syntactical sugar, 70 
testing the class, 72 
error handling. See also error 

messages; exception handling 
for assert statements, 44 
in C++ versus C, 319 
chaining errors, 319-322 
for construction, 27-28 
enforcing return codes, 323-329 
importance of, 323 
inheritance from base class, 15 
reusability and, 31 
virtual methods for, 19 
error messages. See also compiler 

errors and warnings; error 

handling; exception handling; 

return codes or status codes 
assert macro for, 42, 43 
descriptive and informative, 

265, 329 
for ErrorBox function, 102 
exceptions or logging errors 
versus, 31 



internationalization and, 

265, 266 
security issues, 273 
ErrorBox function, 102 
errors.log file, 317 
examples in this book. See also 
class examples; function 
examples; method examples 
compilers and, 1, 3 
entering code by hand, 3 
operating systems and, 1 
typeface conventions, 2-3 
using code from, 1 
exception handling. See also error 
handling; error messages; 
exceptions 
aborting the application 

versus, 43 
application development 

and, 319 
Buf f erExcepti on class for, 

362, 364 
caveats for, 322 
chaining errors, 319-322 
clearing all pointers in the 

destructor, 322 
dealing with un-handled 

exceptions, 317-319 
defined, 312 
memory leaks from, 322 
performance and, 322 
restructuring, 452 
re-throwing exceptions, 319-322 
in Row class for spreadsheet, 

218, 219 
throwing and logging 
exceptions, 312-317 
Excepti onCatcher class 
output from, 317 
passing exceptions to a higher 

level, 320-322 
purpose of, 317 
source-code listing, 
314-315,316 
Excepti onCl ass class 
dealing with un-handled 

exceptions, 318-319 
output from, 317 



passing exceptions to a higher 

level, 320-322 
purpose of, 317 
source-code listing, 313-314, 

315-316 
exceptions. See also exception 
handling 
custom forms versus basic 

types, 364 
defined, 312 

error messages versus, 31 
passing to a higher level, 

319-322 
re-throwing, 319-322 
throwing and logging, 312-317 
unhandled, dealing with, 
317-319 
exiting programs abnormally, 

avoiding, 43 
expertise, challenges of seek- 
ing, 432 
extended Markup Language. 

See XML 
extending 

assignment operators and 

extensibility, 61 
basic types, 59-62 
classes, pure virtual methods 
and, 12 

functionality using abstraction, 
12-18 

i nt type by Range class, 60-62 
IntProperty class, 139-140 
suitability of extension for tem- 
plate classes, 183 
template class, 179-185 
external operators for classes, 61 



factory class 

creating, 163-166 
defined, 162 
derived classes, 162 
enhancing the manager 

class, 167 
memory dumps and, 166 
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methods reporting object state 

for, 166 
RepnU method. 165-166, 167 

mks 

ose function, problems from, 
426, 431 
file processing. See processing 

files 
Fi 1 eChunk class 

data management by, 288 
source-code listing, 284-286 
testing, 289-290 
Fi 1 eChunkManager class 
array management by, 288 
source-code listing, 286-288 
testing, 289-290 
file-guardian class. See 

FileWrapper guardian class 
FileHandler class 
creating, 103-105 
fixing, 106 

open methods, 104-105, 106 
testing, 105 
writing files, 105 
Fi 1 eMai 1 i ngLi st Entry class, 14-15 
files. See also processing files; 
reading files 
delimited, reading, 234-239 
handling input from, 12-13 
opening using multiple paths, 

366-371 
virtual files, 283-290 
files, source-code. See companion 

Web site for this book 
FileWrapper guardian class 
creating, 426-430 
open function, 428-429, 430 
puts function, 429, 430 
testing, 430-431 
Fi rst method, 13-14, 15 
fixed-length input, checking, 

452-453 
fixed-size records, 234. See also 

delimited files 
floating-point values. See complex 
numbers; numbers 



flow 

classes for tracing system flow, 
376-380 

documenting data flow, 416-419 
f open function, 425-426, 430 
f pri ntf function 

problems from, 426 

stream components versus, 225 
free function, 132 
friend class, 167 
Fruit class, 20-22 
Ful 1 class, 52, 53 
function examples 

complex variable utility func- 
tions, 435-436 

ErrorBox, 102 

fopen, 425-426, 430 

Load, 270, 271 

Matrix class manipulation 
functions, 67-68 

open, 428-429, 430 

ProcessEntri es, 17, 18 

puts, 429, 430 

read, 256, 259 

set_termi nate, 318-319 

storage functions for 

ConfigurationFile class, 259 

strip_leading, 247, 248-249 

s t r i p_t r a i 1 i n g , 247, 248-249 

strup function (C language), 
349 

term_func, 318-319 
transform, for converting 
strings, 349-353 
function pointers (C language), 

96-97 
function templates 

automatic generation of, 189 
defined, 186 
implementing, 186-189 
types and, 189 
functionality 

exercising all when testing 

classes, 161 
extending using abstraction, 
12-18 

inheriting data and, 23-29 



mix-in classes for limiting, 168 
saving in base classes, 24 
functions. See also function 

examples; member functions; 
methods; specific kinds 
auto_ptr class with, 303-306 
chaining errors from, 319-322 
complex variable utility 

functions, 435-436 
const keyword for, 77 
for copying strings, memory 

overwrites from, 307-308 
customizing built-in 

functions, 102 
customizing user-defined 

functions, 103-106 
defining default arguments for, 

101-106 
enforcing return codes, 

323-329 
enumerations for integer value 

input to, 72 
free, 132 

with immutable argument, 

78-79 
inline, 407-408 

instantiation of variables and, 

412-413 
macro side effects and calls to, 

49, 50 
macros versus, 49-51 
mal 1 oc, 132 

memory safe buffer class for, 

307-311 
MessageBox, 101-102 
passing objects by reference, 

411-412 
pure virtual functions, 

12-15, 19 
sizeof function, 52-55 
STL algorithm functions, 200 
templates, 186-189 
values passed to, types and, 

90-91, 93-94 
virtual functions, 19-22, 23 
for white space removal, 247, 

248-249 
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^enerafHtfion ot cof e, debugging 

eiwicTHetnrfd>w rea 

delimited files, 234-238 
generic pointers, 175-176 
get methods 

for Compl ete class, 109, 112-113 
for IntProperty class, 138, 

139-140 
for properties, 136 
getCl assName virtual method, 357 
getEl ements virtual method, 357 
gl obal scope, 83 
GNU C++ compiler, 2. See also 

compilers 
GNU organization Web site, 2 
greater-than sign (>), encoding 

required for Web use, 337 
guardian classes 

creating the file-guardian class, 

426-430 
defined, 425 

testing the file-guardian class, 

430-431 
uses for, 425, 426 
wrapping potentially unsafe 

code in, 426 



H 



hackers, strings and, 273 
hash tables 

defined, 279 

in the STL, 279, 281 

Transl ator class using, 279-282 

uses for, 279 
header files 

for Compl ex class definition, 
433, 435 

complex number template in 
the STL, 433 

for configuration-file class, 251 

for MyAl 1 oc class, 298-300 

osdefines.h header file, 39-40 



standard C++ files, problems 

with, 39 
template class implementation 

and, 178, 179 
test program, 40-41 
verifying that OS must be 
defined for, 41 
heap, creating arrays using, 

209-212 
hiding. See also encapsulation 
algorithms from developers, 
7-8 

implementation from users, 11 

HundredsRangeEntry class, 443-444 



icons in margins of this book, 4 
identifying program-specific 

input, 452 
imaginary numbers, 432. See also 

complex numbers 
improving. See enhancing 
#i ncl ude statements for header 

files, 39, 40 
inheritance 

compiler implementation of, 
23-24 

of data and functionality, 23-29 
defined, 23 

of error handling from base 

class, 15 
inherited classes defined, 12 
interfaces and, 354 
levels of, 23-24 
mix-in classes and, 168 
multiple inheritance, 23, 

116-117, 176 
of storage allocation from base 

class, 15 
virtual, 117-119 
inherited classes, 12 
initialization 

assignment versus, 413-415 
Date class code for, 152, 159 
discrete pieces in classes 

for, 159 



of values for classes or 
structures, 76 
inline functions 
defined, 407 

for optimizing code, 407-408 
overhead from, 407 
rules for, 408 
speed and, 407 
input and output 

creating a configuration file, 
250-261 

of data formats, extracting into 
separate classes, 234 

fixed-length, checking, 452-453 

function input enumerations 
for integer values, 72 

identifying program-specific 
input, 452 

input text file for international- 
ization, 272 

reading delimited files, 234-239 

reading in and processing files, 
228-233 

reading internationalization 
files, 272-277 

removing white space from 
input, 246-249 

using stream components to 
format data, 225-227 

writing objects as XML, 240-245 
i nput . cf g file, 260 
inserting tracing into an existing 
file 

caveats for insertion 

programs, 380 
debugFl owTracer objects, 

385, 386 
functionality, 385 
need for, 380 

source-code listing, 381-384 
temp . cpp . tmp file as output, 

385-386 
temporary program to 

illustrate, 385-386 
testing the program, 385-386 
Instance method, 379 
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instantiation 

of templates, header files 



178 




©oksr 



testing for templated classes, 

182-183 
of variables, optimizing, 
412-413 
int type, Range class extending, 
60-62 

Integer class, 411-412 
interfaces 

base classes for, 354 

defined, 354 

seri al i zati on interface, 

355-359 
steps for implementing, 

354-355 
uses for, 354 
internationalization 

application development and, 

265- 266 

building language files for, 

266- 272 

creating input text file for, 272 

defined, 265 

need for, 265, 266 

reading the international file, 

272-277 
Stri ngEntry class for, 

266-268, 271 
Stri ngReader class for, 273-277 
Stri ngWri ter class for, 268-272 
testing the string reader, 

277-278 
threefold process of, 265-266 
Internet, the. See also companion 
Web site for this book; 
URLCodec class 
encoding and decoding for the 

Web, 337-342 
GNU C++ compiler Web site, 2 
planning for Web-enabled 

code, 337 
rules for URLs, 337 



IntProperty class 
extending, 139-140 
get methods, 138, 139-140 
implementing, 137-139 
set methods, 138, 139-140 
source-code listings, 137-139 
testing, 140-141 
using in another class, 139-140 

IsLeapYear method, 35 

IsVal idDate method, 35 

iterators 

for arrays, 291, 292-293 
caveats for, 296 
const versus non-const, 296 
defined, 291 

generic STL iterator, 291 
iterating over STL collection 

classes, 292-296 
for linked lists, 292, 293 
for maps, 292, 293, 295 
need for, 291 

output from test, 295-296 
power of, 296 

removing items using, 294, 296 
reverse iteration, 294, 295 
for streams, 294, 296 
swapping elements using, 294 



jump tables, 23 



K 



KISS (Keep It Simple, Stupid) 
principle, 31, 447 



language files for 

internationalization, 266-272 
leading spaces. See white space 
leap year computations, 30-31, 35 
less-than sign (<), encoding 

required for Web use, 337 



libraries. See also STL (Standard 
Template Library) 
avoiding cumbersomeness, 438 
encoding and decoding meth- 
ods lacking in, 337 
memory leaks in low-level 

libraries, 131 
name resolution problems in C, 
85-86 

name resolution problems with 
classes, 86 

of utility classes, 353 
lifetime. See scope 
linked lists, 292, 293 
linking 

method functions and, 189 

to STL, vector class and, 192 
Load function, 270, 271 
loading 

inline functions and, 407 

pre-loading virtual file 
chunks, 290 

virtual files and speed for, 283 
1 ocal scope, 83 
1 ocal time function, 149 
Lock class 

creating, 421-422 

setLock and unLock 
methods, 422 

testing, 422-424 
LockExcepti on class 

creating, 421-422 

testing, 422-424 
locking a program 

creating the locking mecha- 
nism, 421-422 

custom versus operating sys- 
tem implementation, 420 

defined, 420 

need for, 420 

portability and, 420 

testing the locking mechanism, 
422-424 

ways of implementing, 420 
Log method, 170 
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Logger class 

implementing, 389-390 
outrnjt from. 390 392 

L/ rO C^I^00>Hif3>ff, 390 

lises for, 390 
logging 

actions, by mix-in classes, 

170, 171 
data, for debugging, 389-392 
defined, 389 

error messages versus logging 

errors, 31 
errors, debugging and, 312 



exceptions, 312-317 


implementing a lc 


igging class, 


389-390 




for overloaded methods, 


401-403 




testing the loggin; 


I class, 


390-392 




turning on and of] 


:, 389, 390 


logical errors, 31 




log.txt and log2.tx 


t files, 105 


1 oop scope, 83 




lowercase. See case 




M 




macros 




assert macro, 42-44, 387-389 


avoiding, reasons for, 48-49 



code size increased by, 48 

debugging functionality lack- 
ing for side effects, 48, 49 

determining errors when 
using, 50-51 

function calls and side effects 
of, 49, 50 

functions versus, 49-51 

string macros, avoiding prob- 
lems with, 49-51 

as syntactical sugar, 51 

templates as giant macros, 178 

templates versus, 178 

using appropriately, 51 



mailing-list application 
base class, 13-14 

BaseMai 1 i ngLi stEntry class, 

13- 14 

CommandLi neMai 1 i ngLi stEntry 

class, 16-17 
Fi 1 eMai 1 i ngLi stEntry class, 

14- 15 

handling input from a file, 12-13 

handling input from the 
command line, 12, 13 

mailing-list entries, 12 

in operation, 18 

overview, 12-13 

ProcessEntries function, 17, 18 

steps for creating, 13-15 

testing, 17-18 
maintaining code 

documenting data flow and, 419 

failing to handle errors and, 323 

hiding algorithms and, 8 

separating rules and data from 
code and, 30 
mal 1 oc function, 132 
Manager class, 176-178 
managers. See also factory class 

enhancing the manager 
class, 167 

friend class for, 167 

for virtual files, 283-290 
map class (STL), 281 
maps, iterating over, 292, 293, 295 
Match class 

creating, 331-333 

matches method, 334 

purpose of, 333 

testing, 333-334 

wildcards, 333 
matches method, 334 
Matri x class 

creating, 64-65 

manipulation functions, 67-68 
multidimensional array classes 

modeled on, 65 
operators, 65-66, 67-68 
output from, 69 
overriding operators and, 63 



scalar multiplication, 66-68 

source-code listing, 64-65 

testing, 68-69 
member functions 

pointers to, 96-100 

scoping versus casting, 93-95 
member variables 

checked, 328 

using templates as, 179 
member-function pointers 

defined, 96-97 

function pointers (C language) 

versus, 96-97 
implementing, 97-98 
power of, 96 

testing member pointer code, 

99-100 
updating code with, 99 
memcpy function, memory over- 
writes from, 307-308 
memory 

STL use and, 192, 195, 196, 199 
virtual files for conserving, 283 
memory allocation. See also 
memory leaks; memory 
tracking program 
for arrays of object 

pointers, 214 
arrays of objects and, 209 
for arrays, with and without 

pointers, 204-208 
avoiding assuming contiguous 

order for strings, 349 
avoiding overwrites, 307-311 
customizing, 297-302 
delete operator problems for, 

128-129 
deleting array elements 

and, 204 
embedded processors and, 135 
free function for de-allocation, 
132 

guardian classes and, 425 
mal 1 oc function for, 132 
new operator problems for, 
128-129 
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overloading new and del ete 
operators to track, 129-135 

set te rminate function 

with 

memory-leak tool, 133 
two pointers for same block, 28 
using auto_ptr class, 303-306 
memory allocators 

creating a custom allocator, 

298- 300 

methods overridden by, 

299- 300 

for new and del ete operators, 

129-135 
output from test driver, 302 
overriding for STL collections, 

297-302 
purpose of, 297 
STL complications for, 297 
test driver for custom 

allocator, 301-302 
memory leaks. See also memory 
allocation 
auto_ptr class for avoiding, 

303-306 
avoiding versus fixing 

problems, 303 
deleting all manager class 

objects at shutdown 

and, 167 
duration of, 82 
exception handling and, 322 
from failure to delete arrays 

properly, 204, 208, 209, 212 
in low-level libraries, 131 
from macro side effects, 51 
memory allocation by func- 
tions and, 129 
from not matching deletion 

method with invocation 

method, 84, 204, 212 
object allocation by manager 

class and, 167 
from pointers, 212, 303 
set methods for NULL pointers 

and, 109 



STL container class implemen- 
tation and, 210 
storing derived objects in an 

array and, 213 
storing pointers to objects in 

arrays and, 212 
testing production code with 

memory-leak tool, 133 
tracking memory allocation to 

avoid, 128, 131, 134 
memory overwrites 

Buffer class for avoiding 

(example 1), 308-311 
Buffer class for avoiding 

(example 2), 361-365 
buffer overflows, 360 
from copying strings, 307-308 
defined, 307 
difficulties tracking, 307 
memory safe buffer class, 

307-311 
problems from, 307 
memory safe buffer class, 307-311 
memory tracking program 
allocation report, 131 
new and del ete handlers, 

129-131 
output from, 133-134 
overloaded new and delete 

handlers, 131-132 
rules for new and del ete 

handlers, 129 
testing, 133-135 
MessageBox function, 101-102 
method examples. See also 
examples in this book 
accessor methods for MyStri ng 

class, 123 
al 1 ocate, overriding, 299, 300 
complex variable utility 

methods, 435-436 
construct, overriding, 299, 300 
c_str, for converting 

strings, 349 
deal 1 ocate, overriding, 300 
decode, 339-340, 341 
destroy, overriding, 299, 300 



do_xor, 346, 347 

Encode (Stri ngCodi ng class), 

9, 10-11 
encode (URLCodec class), 339, 

340, 341 
First, 13-14, 15 
getCl assName, 357 
getEl ements, 357 
Instance, 379 
IsLeapYear, 35 
IsVal idDate, 35 
Log, 170 
matches, 334 

Multiply method template, 
189-191 

myVector, 301, 302 

Next, 13-14, 15 

non-inline methods for cDate 

class, 34-35 
open (Fi 1 eHandl er class), 

104-105, 106 
OpenFile, 28 
operator, 351 
operator-, 402, 403 
ProcessEntri es, 17, 18 
puts, 429, 430 
Report, 165-166, 167 
Save, 270, 272 
setLock, 422 
setX, 402, 403 
undo, 418, 419 
un Lock, 422 

write member method, 

356-357 
writing files, 105 
method templates 
creating, 189-190 
defined, 186 
testing, 190-191 
uses for, 189 
methods. See also functions; 
member functions; method 
examples; specific kinds 
al 1 ocate, overriding, 299, 300 
class with methods containing 

default values, 103-106 
complex variable utility 
methods, 435-436 
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methods (continued) 
const keyword for, 77 
con stru ct, overriding, 299, 300 
k300 
_ leth- 

ods, 399-403 
defining default arguments for, 

101-106 
destroy, overriding, 299, 300 
differentiating with const key- 
word, 81 
encapsulating, for encrypting 

strings, 7-11 
enforcing return codes, 323-329 
inline, 407-408 
minimizing in classes, 31 
in mix-in classes, controlling 

availability, 168-169 
MyStri ng class accessor meth- 
ods, 123 
non-static, working with, 104 
for opening a file using multi- 
ple paths, 366-371 
overloaded, defined, 399 
overridden by memory alloca- 
tor, 299-300 
pure virtual methods, 12-15, 
19 

for reading delimited files, 
generic, 234-238 

reporting object state for fac- 
tory class, 166 

required for Compl ete class, 
109 

scoping member functions ver- 
sus casting, 93-95 
self-cloning, 167 
signatures for, 399 
static, jump tables for, 23 
templates, 186, 189-191 
virtual methods, 19-22, 23 
for writing files, 105 

mi n macro side effects, 48-49 

mix-in classes 
compiling, 170 

controlling available methods, 
168-169 



creating a single functional 
class from, 24-26 

implementing, 169-170 

inheritance and, 168 

logging by, 170, 171 

overview, 168-169 

testing, 170-171 

using, 168-171 
monospaced font in this book, 2-3 
Mul ti PathFi 1 e class 

creating, 367-369 

described, 369 

improving, 371 

path delimiter for, 369 

responsibilities of, 366 

saving and reading paths, 371 

testing, 369-371 
multiple inheritance. See also 
virtual inheritance 

compiler errors for, 117 

defined, 23 

deriving all objects from com- 
mon base class and, 176 
example, 116-117 
multiple operating systems, 

handling, 39-41 
multiple paths, opening a file 

using, 366-371 
Multiply method template 
creating, 189-190 
testing, 190-191 
MyAl 1 oc class 

creating, 298-300 
methods overridden by, 

299-300 
test driver, 301-302 
MyBuffer class, 301-302 
My CI ass for overloaded methods 
adding logging, 401-402 
initial implementation, 399-401 
opera to r= method, 402, 403 
output from, 401, 402-403 
setx method, 402, 403 
My C 1 a s s test class for 

seri al i zati on interface, 
358-359 
MyCl ass .xml file, 359 



my . eng file, 272 

my . eng . i dx file, 272 

my_min template function, 186-189 

MyReturnVal ue class 

output from, 328 

source-code listing, 326-327 
MyStri ng class 

accessor methods, 123 

as complete class, 123 

constructors, 123 

implementing, 122-123 

operators, 124-125 

testing, 125-127 
MyStri ngArray class 

creating, 196-198 

memory and speed and, 199 

output from, 198 
myVector method, 301, 302 



N 



name resolution. See also 
namespaces 
C++ versus C and, 85-86 
namespaces and, 86 
problems for classes in 

libraries, 86 
namespaces 

basic format for defining, 86 
class name collision avoided 

by, 86 
creating a namespace 

application, 86-88 
document class, 87-88 
placing reusable classes in, 89 
testing the application, 88-89 
using in an application, 88 
using namespace statement 

for, 87 

new in pi ace operator, 135 
new operator 

for array allocation, 211 
array operator, 134-135 
calling correct delete operator 

for, 135 
character pointers and, 
134-135 
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handler for, 129-131 
memory allocation problems 




'output from memory tracking 

program, 133-134 
overloaded handler for, 

131-132 
overloading to track memory 

allocation, 129-132 
rules for handler 

implementation, 129 
uses for, 128 
Next method, 13-14, 15 
non-class template arguments, 

184-185 
non-const iterators, 296 
non-static methods, 104 
NoPoi nter class 
creating, 204-206 
output from, 207-208 
nulls 

memory leaks and set meth- 
ods for NULL pointers, 109 

string classes and, 348 
numbers 

complex, working with, 
432-438 

converting to words, 438-446 

encrypting credit card 
numbers, 343 

enumerations, 70-72 

Social Security Number 
validation, 142-148 
NumberToWords class 

base classes for, 440-444 

implementing, 445-446 

testing, 446 

0 



Object base class 

for factory class, 163-166 
Report method, 165-166, 167 
testing the factory, 166-167 



object pools 

for common base class, 162 
new in pi ace operator and, 135 
object-array allocation 

creating an array of objects, 

210-211 
output from the array alloca- 
tion program, 211-212 
ways of creating arrays of 
objects, 209-210 
objects 

arrays of object pointers, 

213-215 
arrays of objects, 209-212 
deriving all from common base 

class, 176 
methods reporting state of, 166 
passing by reference, 410-412 
passing by value, 408 
scope handled automatically 

for, 82-83 
temporary, avoiding, 408-410 
XMLE1 ement objects, 243 
OnesRangeEntry class, 441-442 
open function, 428-429, 430 
open methods (Fi 1 eHandl er 

class), 104-105, 106 
OpenAndReadFi 1 eNew method, 

231, 232 
OpenAndReadFi 1 eOl d method, 

230, 232 
OpenFi 1 e method, 28 
opening a file using multiple paths 
configuration files and, 367 
Di rectoryLi st class for, 

367-368, 369 
improving the class for, 371 
Mul ti PathFi 1 e class for, 

367-371 
operating systems and, 366 
path delimiter for, 369 
responsibilities of utility class 
for, 366 
operating systems 

critical-section handlers, 420 
examples in this book and, 1 
locking by, 420 
multiple, handling, 39-41 



opening files and, 366 
32-bit, 54 
operator keyword, 122 
operator method, 351 
operator- method, 402, 403 
operators 

assignment operators and 

extensibility, 61 
complex variable utility 

methods, 435-436 
conversion operators, 122 
enumerations and, 70 
external operators for 

classes, 61 
Matrix class, 65-66, 67-68 
overloaded, 120-127 
overriding, arrays and, 63 
polymorphism, 19 
Range class, 61 
for retrieving line of file into 

string object, 231,232 
strings and xor operation, 348 
optimization. See also overhead; 
speed 

in application development 
process, 407 

asserts not defined in opti- 
mized mode, 387, 389 

avoiding temporary objects, 
408-410 

initialization versus assign- 
ment and, 413-415 

inline functions for, 407-408 

passing objects by reference, 
410-412 

post-development, 407 

postponing variable 
declarations, 412-413 

testing asserts in optimized 
environment, 44 

of variable instantiation, 
412-413 
osdef i nes . h header file 

creating, 39-40 

source-code listing, 40 

test program, 40-41 

verifying that OS must be 
defined for, 41 
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output. See input and output 
overhead. See also optimization; 

Droplocks 

\rom STL use, 192, 195, 196, 

199, 209 
structures for minimizing, 74 
for templates, 179 
from temporary objects, 

408-410 
usefulness of classes and, 438 
from vector class, 192, 195 
for virtual versus non-virtual 

methods, 21 
overloaded methods 
class with, 400-401 
debugging, 399-403 
defined, 399 
logging, 401-403 
signatures for, 399 
overloaded operators 

associated operators and, 

121-122 
benefits of, 120-121, 127 
conversion operators, 122 
creating only when 

necessary, 121 
debugging complicated by, 121 
for memory allocation track- 
ing, 129-135 
MyString class for, 122-127 
new and del ete operators, 

129-135 
power of, 127 
rules for creating, 121-122 
side effects, avoiding, 121 
standard usage and, 121 
using, 122-125 
for vector objects, 227 
overriding classes 

allocator for collections, 

297-302 
pure virtual methods and, 14 
virtual methods and, 19, 21, 

162-167 

overriding methods for memory 
allocator, 299-300 



overriding operators 

arrays and, 63 

comparison operators, 328 
overwriting memory. See memory 
overwrites 

P 



auto_ptr class for avoiding 

memory leaks, 303-306 
in C++ versus C, 175 
character, new operator and, 

134-135 
clearing in destructor for 

exception object, 322 
generic, 175-176 
member-function pointers, 

96-100 

memory leaks from, 212, 303 
for same memory block, 28 
size of, 54 

si zeof function with, 55 
structures and, 76 
void pointers, 175, 176 
polymorphism 

customizing a class with, 20 
defined, 19 
portability. See also reusability 
custom locking mechanism 

and, 420 
opening files and, 366 
separating rules and data from 
code for, 31 
post-conditions for code in 

DBC, 393 
postponing variable declarations, 

412-413 
preci si on method for 

streams, 227 
preconditions for code in DBC, 
392, 397 

pre-loading virtual file chunks, 290 
pre-processor 

assert statements and, 42-44 
#define versus const state- 
ment and, 45, 47 
handling multiple operating 

systems, 39-41 
header files and, 39-41 
macro code and, 48 
macros and, 48-51 
si zeof function and, 52-55 
using const instead of #def i ne, 
45-47 



Parser class, 450-451 
ParserFi 1 e class, 450, 451, 

452-453 
passing 

exceptions to a higher level, 

320-322 
objects by reference, 410-412 
objects by value, 408 
values to functions, types and, 
90-91, 93-94 
passwords 

encryption for, 343 
white space and, 246 
path delimiter, 369 
paths, opening a file using multi- 
ple, 366-371 
percent sign (%) as wildcard, 331 
performance. See optimization; 

overhead; speed 
physical errors, 31 
plus operator (+), overloading, 

120-122 
plus-equal operator (+=), plus 
operator implementation 
and, 121 
Poi nt class 

constructors, 414, 415 
implementing, 413-414 
output from, 415 
Poi nterCl ass class 
creating, 204-206 
output from, 207-208 
pointers 

allocating arrays with and 

without, 204-208 
allocation not verified by C++ 

before freeing, 132 
arrays of object pointers, 
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Drop 



print statements for 

debugging, 208 
pri nti^unction, stream compo- 




arrays using streams, 226-227 
virtual methods for, 19 
ProcessEntri es function, 17, 18 
processing files 

C++ versus C and, 425-426 
creating the test file, 233 
C-style file-handling function 

problems, 425-426 
data processing with same 

code, 228 
file-reading class, 228-230 
opening using multiple paths, 
366-371 

reading delimited files, 234-239 
reading internationalization 

files, 272-277 
testing file-reading code, 232 
using streams for file reading, 

230-233 
virtual files and speed for, 283 
word-parser program, 448-451, 
452-453 
Processor class, 98-99 
Processor2 class, 99 
Processor2 class test driver, 99 
processors, new in pi ace opera- 
tor and embedded, 135 
program-specific input, 

identifying, 452 
properties 

in C# and Java, 136, 141 
class for implementing, 

137-139,417-418 
defined, 136 

extending the implementation 

class, 139-140 
invalid assignments and, 

136-137 
read-only, 137 

set and get methods for, 136 
testing the implementation 
class, 140-141, 418-419 



Properties class (example 1) 
for Conf i gurati onFi 1 e class, 
24-25 

virtual destructors in, 24, 25 
Properties class (example 2) 
for documenting data flow, 

417-419 
implementing, 417-418 
testing, 418-419 
undo method, 418, 419 
protecting data 

with encapsulation, 7-11 
from memory overwrites, 
307-311 
pure virtual base classes for 

interfaces, 354 
pure virtual methods. See also 
virtual methods 
abstraction and, 12 
code reuse through, 12 
defined, 12 

derived classes and, 354 
Fi rst method, 13-14, 15 
Next method, 13-14, 15 
virtual methods versus, 19, 354 
puts function, 429, 430 



Q 



question mark (?) 
with Match class, 333 
as wildcard, 330-331, 333 



Range class 

assignment operators in, 61 

enumerations compared to, 71 

implementing, 60-62 

need for, 59-60 

operators, 61 

source-code listing, 60-61 

testing, 62 
RangeEntry class, 440-441 
read function, 256, 259 



readability 

enumerations for, 70, 71 
overloaded operators and, 121 

read_f i 1 e function, chaining 
errors from, 321 

reading files 

creating the test file, 233 
data processing with same 

code, 228 
delimited files, 234-239 
file-reading class, 228-230 
internationalization file, 

272-277 
opening a file using multiple 

paths, 366-371 
testing file-reading code, 232 
using streams, 230-233 
virtual files and speed for, 283 
word-parser program, 448-451, 
452-453 

read-only properties, 137 

read_record function, chaining 
errors from, 321 

reducing the complexity of code 
basic principles, 447 
by componentizing, 449-451 
KISS principle for, 31,447 
by restructuring, 451-452 
sample program, 447-449 
by specialization, 452-453 

redundant code, restructuring, 
451-452 

refactoring, 451-452 

regression tests, 436 

"release mode" for assert 
macro, 388 

removing 

items using iterators, 294, 296 
white space from input, 
246-249 

Report method, 165-166, 167 

restructuring, 451-452 

re-throwing exceptions 
code example, 320-321 
output using, 321-322 
uses for, 319 
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retrieving line of file into string 

object, 232 
return cod es or status codes 

O^QliN^-329 

eturn code class, 324-329 
in signatures for methods, 399 
status codes defined, 323 
typical example, 323 
RetVal ue class 

copy constructor, 329 
output from, 328 
overview, 328 

source-code listing, 324-327 
reusability. See also portability; 
templates 
for business rule code, 30, 31 
C++ versus C and, 85 
collections and, 291 
for date code, 30, 31 
encapsulation and, 30, 31 
encoding and decoding class 

for, 337 
error handling and, 31 
generic method for reading 

delimited files and, 234 
placing classes in namespaces 

for, 89 

pure virtual methods and, 12 
reverse iteration, 294, 295 
Rot 13 encryption algorithm, 343, 

344-346 
R0T13Encrypti on class 
algorithm described, 344 
EBCDIC systems and, 345 
implementing, 344-345 
testing, 345-346 
Row class for spreadsheet 
creating, 218-219 
exception handling in, 218, 219 
functionality needed for, 216 
RSS encryption algorithm, 343 
rules 

for auto_ptr class, 306 
business rules, 30-36 
for Compl ete class, 109 
for del ete handler 

implementation, 129 
for inline functions, 408 



for new handler 

implementation, 129 

for overloaded operator cre- 
ation, 121-122 

of specialization, 452-453 

for types, encapsulating within 
a class, 142 

for URLs, 337 
run-time 

assert macro and, 42, 389 

turning logging on and off, 
389, 390 



Save method, 270, 272 
Save mix-in class, 169-171 
SavePai rs class, 25-26, 28-29 
scope 

arrays of objects on the stack 

and, 209 
defined, 82 

global, local, and loop, 83 

handled automatically for 
classes and objects, 82-83 

scoping member functions ver- 
sus casting, 93-95 

scoping variables, 82-84 

viewing visually, 83-84 
searching 

for files across multiple paths, 
366-371 

hash table for search and 
replace, 279 

wildcards for, 330-334 
security 

buffer overflows and, 360, 361 

hiding algorithms and, 8 

strings and, 273 
separating rules and data from 

code, 30-36 
Sen' al i zati on class 

getCl assName virtual 
method, 357 

getEl ements virtual 
method, 357 

source-code listing, 356-357 

write member method, 356-357 



serialization interface 

implementing the serializa- 
tion interface, 355-358 

interface defined, 354 

serialization defined, 354 

steps for implementing an 
interface, 354-355 

testing the seri al i zati on 
interface, 358-359 
Seri al i zeEntry class 

source-code listing, 355-356 

testing, 358-359 
set methods 

for Complete class, 109, 112 

for IntProperty class, 138, 
139-140 

for properties, 136 
setLock method, 422 
s e t_t e rm i n a t e function 

described, 318 

divide-by-zero error and, 
317-319 

output from application, 319 

using in applications, 318-319 
setx method, 402, 403 
SGML, XML as variant of, 240 
side effects 

of macros, 48-49, 50 

of mi n macro, 48-49 

of overloaded operators, 121 
signatures for methods, 399 
simplicity. See also reducing the 
complexity of code 

KISS principle for, 31, 447 

usefulness of classes and, 438 
si zeof function 

arrays and, 55 

evaluating results of, 54-55 

with pointers, 55 

pre-processor and, 52 

uses for, 52 

using, 52-54 
Social Security Number validation 

constants for SSN length and 
delimiter, 143, 146 

defining the Val idator object 
for, 142-143 

testing, 146-148 

validation module for, 143-146 
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source-code files. See companion 

Web site for this book 
source^ode listings 

) |^cl^)VJI;Wsi\lDknd 

' without pointers, 205-206 
array of object pointers, 214 
auto_ptr test program, 305 
base class for casting, 91-92, 94 
Base template class, 180-182 
Base template class test 

driver, 183 
base-class inheritance, 118 
BaseMai 1 i ngLi stEntry class, 
13-14 

Buffer class (example 1), 

308-310 
Buffer class (example 2), 

361-363 
Buffer class test driver, 364 
Buf f erExcepti on class, 362 
cDate class implementation, 

32-34 
cDate class non-inline 

methods, 35 
cDate class test program, 36 
ChangeManagement class, 115 
Col umn class, 217 
command processor class, 99 
command processor class test 

driver, 99 
Command Li neMai 1 i ngLi stEntry 

class, 16-17 
Complete class implementa- 
tion, 110-113 
Complete class test driver, 114 
Compl ex class definition, 433 
Complex class implementation, 

434-435 
Compl ex class test program, 437 
Compl ex class variable 

methods, 436 
Conf i gurati onFi 1 e 

class (example 1) 

implementation, 26 
Conf i gurati onFi 1 e 

class (example 1) test 

program, 27 



Conf i gurati onFi 1 e class 

(example 2) definition, 251 
Conf i gurati onFi 1 e 

class (example 2) 

implementation, 256 
Conf i gurati onFi 1 e 

class (example 2) test 

program, 260 
ConfigurationFile.cpp file, 

251-259 
Conf i gurati onFi 1 e . h header 

file, 251 

const keyword to differentiate 

methods, 81 
constants and their 

definitions, 78 
constants in classes, 79-80 
conventions in this book, 2-3 
conversion base classes, 

440-444 
conversion code for STL string 

class, 350-351 
Date class definition, 150-151 
Date class functionality, 

152-158 
Date class source file, 151-152 
Date class test driver, 159-160 
DBCObject class implementa- 
tion, 393-397 
DBCObject class test program, 

397-398 
debugFl owTracer class imple- 
mentation, 376-377 
debugFl owTracer class test pro- 
gram, 379 
debugFl owTracerManager class, 

378-379 
decode method, 339-340 
Del i mi ted Fi 1 e Parser class, 

237-238 
Del i mi tedRow class, 236-237 
Delimiters class, 235-236 
derived class test drivers, 
93, 95 

derived classes for casting, 
92, 94 

Design by Contract example, 
393-397 



Design by Contract test pro- 
gram, 397-398 
Di rectory Li st class, 367-368 
document class, 87-88 
Encode method, 9, 10-11 
Excepti onCatcher class, 

314- 315, 316 

Excepti onCl ass class, 313-314, 

315- 316 

factory class, 163-166 
factory object test driver, 

166-167 
file read test driver, 232 
FileHandler class 

implementation, 103-104 
FileHandler class test 

driver, 105 
FileMail ingListEntry class, 

14-15 

file-reading class, 228-230 
Fi 1 eWrapper guardian class 

implementation, 427-429 
Fi 1 eWrapper guardian class 

test program, 430-431 
Fi rst method, 13-14, 15 
Fruit class, 20 

function with immutable argu- 
ment, 78 
header file test program, 40-41 

HundredsRangeEntry class, 

443-444 
inserting tracing into an 

existing file, 381-384 
IntProperty class 

extension, 139 
IntProperty class 

implementation, 137-139 
Lock class implementation, 421 
Lock class test driver, 422-423 
LockExcepti on class 

implementation, 421 
LockExcepti on class test 

driver, 422-423 
Logger class implementation, 

389-390 
Logger class test driver, 391 
macro file, 49-51 
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SOUrce-COde listings (continued) 

mailing-list application test 

Tlatri x class implementation, 
64-65 

Matrix class manipulation 

functions, 67-68 
Matrix class operators, 66, 67 
Matrix class test driver, 68 
memory allocator test 

driver, 133 
mix-in class, 169-170 
Mul ti PathFi 1 e class 

implementation, 367-369 
Mul ti PathFi 1 e class test 

program, 370 
multiple inheritance, 116 
Multiply method template, 

189-190 

Multiply method template test 

driver, 190 
MyAl 1 oc class definition, 

298-300 
MyAl 1 oc class test driver, 301 
MyBuffer class, 301 
My CI ass test class for seriali- 
zation interface, 358-359 
my_mi n template function, 

187-188 
MyReturnVal ue class, 326-327 
My St ring class accessor 

methods, 123 
MyStri ng class 

implementation, 123 
MyStri ng class operators, 

124-125 
MyStri ng class test driver, 126 
MyStri ngArray class, 197-198 
new and del ete handlers, 130 
Next method, 13-14, 15 
NumberToWords class 

implementation, 445 
NumberToWords class test 

program, 446 
Object base class, 163-166 



object-array allocation 

program, 210 
OnesRangeEntry class, 441-442 
Open Fi 1 e method, 28 
osdef i nes . h header file, 40 
overloaded methods, initial 

implementation, 400-401 
overloaded methods, logging 

added, 401-402 
overloaded new and del ete 

handlers, 132 
Parser class, 450-451 
Pa rserFi 1 e class, 450 
passing objects by 

reference, 411 
Point class, 413-414 
pointers to member functions, 

97-98 

printing arrays using streams, 

226-227 
ProcessEntries function, 17 
Properti es class for 

Conf i gurati onFi 1 e class, 

24-25 

Properti es class for docu- 
menting data flow, 417-418 

Properties class test program, 
418-419 

Range class implementation, 
60-61 

Range class test driver, 62 
RangeEntry class, 440-441 
reading delimited files, 

235-238 
RetVal ue class, 324-327 
R0T13Encrypti on class 

implementation, 344-345 
R0T13Encrypti on class test 

driver, 345 
Row class, 218 
Save mix-in class, 169-170 
SavePai rs class, 25, 29 
for scope illustration, 83 
Seri al i zati on class, 356-357 
serialization interfacetest 

driver, 358-359 
Seri al i zeEntry class, 355-356 



set_termi nate function, 318 
simple template, 176-177 
sizeof program, 53 
Spreadsheet class 

implementation, 219-220 
Spreadsheet class test 

driver, 221 
SSNVal idator class 

implementation, 143, 

144-145 
SSNVal idator class test driver, 

146-147 
St ri ngCodi ng class 

implementation, 8-9 
Stri ngCodi ng class update, 

10-11 

Stri ngConvertTo LowerCase 

class implementation, 351 
Stri ngConvertTo LowerCase 

class test driver, 352 
StringEntry class, 266-268 
StringReader class, 273-277 
StringUtil utility class, 

252-255 
Stri ngwri ter class, 268-271 
structure implementation, 

74-75 

structure test harness, 75 

temp . cpp file, 385 

template class with non-class 

argument, 184 
templated class test driver, 183 
templated classes in code, 

180-182 
temporary objects, 408-409 
TensRangeEntry class, 443 
test driver for constant 

application, 80-81 
test drivers for casting, 93, 95 
TestlntValue class 

implementation, 140 
TestlntVal ue class test 

driver, 149 
Thousands RangeEntry 

class, 444 
Tracker class, 304-305 
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Transl ator class 

implementation, 280 
Tra nsl ator class^test driver, 



DroQSacfe 

338-340 



ntation, 



URLCodec class test driver, 

340-341 
using casts, 91-92 
using code in your own 

programs, 1 
using constants, 46 
using namespace statement, 87 
using namespaces in an 

application, 88 
using streams for file reading, 

230-231 
using vector class, 193-194 
using wrong namespace 

class, 89 
vector algorithm program, 

201-202 
white space removal code, 

246-248 
word-parser program 

componentized, 450-451 
word-parser program original, 

448-449 
XMLE1 ement class, 241-242 
XMLSuperCl ass class, 244 
XMLWriter class, 241-243 
XMLWriter class test driver, 

243-244 
XOREncrypti on class 

implementation, 346-347 
XOREncrypti on class test 

driver, 348 
specialization, 452-453 
speed. See also optimization; 
overhead 
exception handling and, 322 
inline functions and, 407 
STL use and, 199 
virtual files for conserving, 283 
spelling out numbers. 

See converting numbers 
to words 



splitting into components. See 

componentizing 
Spreadsheet class 
Col umn class for, 216, 

217-218, 221 
creating, 219-221 
data encapsulation in, 216 
Row class for, 216, 218-219 
testing, 221-222 
spreadsheets 

basic elements, 216 
creating the column class, 

217-218 
creating the row class, 218-219 
creating the spreadsheet class, 

219-221 
mimicking a two-dimensional 

array, 222 
overview, 216 
shell from STL, 216 
simple arrays versus, 216 
testing, 221-222 
spri ntf function versus stream 

components, 225 
SSNVal i dator class 

constants for SSN length and 

delimiter, 143, 146 
defining the Validator object, 

142-143 
Social Security Number 

validation module, 143-146 
testing, 146-148 
stack, declaring arrays on, 

209-212 
Standard Template Library. 

See STL 
static arrays 

buffer overflow and, 361 
declaring on the stack, 209, 211 
static data members, 424 
static methods 

calling as a default value, 104 
jump tables for, 23 
status codes. See return codes or 

status codes 
stdi o . h header file (Windows), 
39, 41 



STL (Standard Template Library) 
algorithm functions, 200 
auto_ptr class, 303-306 
benefits of, 199, 200 
collections, 291-296 
complex number template 

in, 433 
configurable classes as 

strength of, 297 
container classes, 179, 200, 

209-212 
creating arrays of objects 

using, 209-212 
documentation, 199 
hash tables in, 279, 281 
inserting classes in 

templates, 297 
iterating over collection 

classes, 292-296 
map class, 281 

memory allocation complica- 
tions for, 297 
multiple array classes and, 196 
overhead from using, 192, 195, 

196, 199, 209 
overriding the allocator for 

collections, 297-302 
Properti es class use of, 25 
for spreadsheet shell, 216 
transform function, 349-353 
using arrays from, creating 

your own versus, 199 
vector class, 25, 192-195, 
200-203, 209-212 
storage allocation. See also 
data storage 
inheritance from base class, 15 
in Matri x class, 65 
section of classes for, 23 
storage classes. See container 

classes (STL) 
strcpy function, memory over- 
writes from, 307-308 
stream components 
benefits of, 225 
C-style functions versus, 225, 
228, 231-232, 233 
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stream components (continued) 
file reading using, 230-231 
file-reading class 228-230 

DropBaofer 7 

Iterating over, 294, 296 
passing objects to functions, 

410-411 
preci si on method, 227 
testing file-reading code, 232 
vectors with, 226-227 
width method, 227 
string array class 
creating, 196-198 
memory and speed and, 199 
output from, 198 
string macros, avoiding problems 

with, 49-51 
string objects, nulls or control 

characters and, 348 
Stri ngCodi ng class 
benefits of, 7-8 
creating and implementing, 
8-10 

Encode method, 9, 10-11 

output from, 10 

source-code listing, 8-9 

updating, 10-11 
Stri ngConvertToLowerCase class 

creating, 350-351 

operator method, 351 

testing, 351-353 
Stri ngEntry class 

creating, 266-268, 271 

input text file for, 272 
StringEntry.cpp file, 272 
Stri ngReader class 

building, 271-277 

testing, 277-278 
strings 

associated operators for, 
121-122 

avoiding assuming contiguous 
order for, 349 

as containers of characters, 349 

control characters and string 
classes, 348 



converting case, 349-353 
converting numbers to words, 

439-446 
encapsulated encryption 

method for, 7-10 
encoding and decoding for the 

Web, 337-342 
encrypting and decrypting, 

343-348 
encrypting text string files, 273 
hackers and, 273 
implementing the transform 

function to convert case, 

350-351 
Match class for wildcard 

searches, 331-334 
memory overwrites from 

copying, 307-308 
My Stri ng class for overloaded 

operators, 122-127 
MyStri ngArray class, 196-199 
nulls and string classes, 348 
retrieving line of file into string 

object, 232 
security issues, 273 
size of, 54 

storing literal information in 
classes, 161 

Stri ngCodi ng class, 8-11 

Stri ngEntry class for interna- 
tionalization, 266-268, 271 

Stri ngReader class for interna- 
tionalization, 273-277 

StringUtil utility class 
for configuration files, 
252-255, 259 

Stri ngWri ter class for 
internationalization, 
268-272 

testing the string case 
conversion, 351-353 

testing the string reader, 
277-278 

word-parser program, 447-451, 
452-453 

written by Logger class, 390 

xor operation and, 348 



StringUtil utility class, 

252-255, 259 
Stri ngWri ter class 

building, 268-272 

Load function, 270, 271 

Save method, 270, 272 
stri p_l eadi ng function, 247, 

248-249 
stri p_trai 1 i ng function, 247, 

248-249 
struct construct 

as beginning of 
encapsulation, 73 

in C++ versus C, 74 

as a class with public 
members, 73 

defining, 74-75 
structures 

in C++ versus C, 73-74 

classes versus, 76 

constructors for, 76 

derived, 75, 76 

implementing, 74-75 

initialization of data values 
required for, 76 

interpreting output, 75-76 

limitations of, 74 

overhead minimized by, 74 

overriding classes, 73 

pointers and, 76 

test harness, 75 

v-tables missing from, 74, 76 
strup function (C language), 349 
support, documenting data flow 

and, 419 
swapping elements using 

iterators, 294 
syntactical sugar 

enumerations as, 70 

macros as, 51 

T 



Telles, Matthew (C++ Timesaving 

Techniques For Dummies), 1-4 
temp . cpp file, 385 
temp . cpp . tmp output file, 385-386 
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tempi ate keyword, 178 
templated functions 

autonjatic generation of, 189 
ifl 




■types and, 189 
templated methods 
creating, 189-190 
defined, 186 
testing, 190-191 
uses for, 189 
templates. See also STL (Standard 
Template Library) 
auto_ptrs in STL collections, 
306 

benefits of, 110 

class template arguments, 179, 
182, 183 

compilers and tempi ate key- 
word, 178 

Complete class, 110-113 

for complex numbers in the 
STL, 433 

constructors and destructors 
and, 178 

creating a simple template 
class, 175-178 

defined, 175 

extending a template class, 

179- 185 

function templates, 186-189 

as giant macros, 178 

header files for implementing 

classes, 178, 179 
implementing classes in code, 

180- 182 
macros versus, 178 

method templates, 186, 189-191 
non-class template arguments, 

184-185 
overhead for, 1 79 
for printing arrays using 

streams, 227-228 
STL classes in, 297 
suitability for extension, 183 
testing template classes, 

182-183 



ways of using, 179 

wrapping pointers in auto_ptr 

template object, 303-305 
temporary objects 
avoiding, 408-410 
code example overdoing, 

408-409 
output from code example, 410 
processes creating, 408 
TensRangeEntry class, 443 
term_func function, 318-319 
test_del i mi ted . txt file, 239 
test .in. eng file, 272 
testing. See also debugging 
asserts in optimized environ- 
ment, 44 
Buffer class, 364-365 
casts, 93, 94-95 
cDate class, 35-36 
code for converting numbers 

to words, 446 
Compl ete class, 113-115 
Conf i gurati onFi 1 e class 

(example 1), 27 
Conf i gurati onFi 1 e class 

(example 2), 260-261 
constant application, 80-81 
creating generic test drivers 

for validators, 148 
Date class, 159-161 
DBCObject class, 397-398 
debugFl owT racer class, 379-380 
delimited-file-reading code, 

238-239 
Design by Contract 

methodology, 397-398 
enumeration class, 72 
exercising all functionality for 

classes, 161 
Fi 1 eHandl er class, 105 
file-reading code, 232 
Fi 1 eWrapper guardian class, 

430-431 
inserting tracing into an 

existing file, 385-386 
IntProperty class, 140-141 
iterators, 295-296 



Logger class, 389-390 
mailing-list application, 17-18 
Match class, 333-334 
Matri x class, 68-69 
member pointer code, 99-100 
memory tracking program, 

133-135 
mix-in classes, 170-171 
Multiply method template, 

190-191 
MyAl 1 oc class, 301-302 
MyString class, 125-127 
namespace application, 88-89 
non-class template arguments, 

184-185 
osdef i nes . h header file, 40-41 
Properti es class, 418-419 
providing test suite with appli- 
cation file, 436 
Range class, 62 
regression tests, 436 
ROf 13Encrypti on class, 

345-346 
serial ization interface, 

358-359 
Spreadsheet class, 221-222 
SSNVal idator class, 146-148 
string case conversion, 

351-353 
StringReader class, 277-278 
structures, 75-76 
template classes, 182-183 
f racker class, 305-306 
f ransl ator class, 281-282 
unit tests versus complete 

tests, 115 
URLCodec class, 340-341 
validation versus, 115 
virtual file class, 289-290 
white space removal 

application, 249 
XMLWriter class, 243-245 
XOREncrypti on class, 347-348 
festlntVal ue class, 140-141 
test . out file, 431 
test2.xml file, 244 
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for file-reading code, 233 
for rmx-in classeSj 170-171 

1 files, 250 
32-bit operating systems, 54 
ThousandsRangeEntry class, 

444, 445 
throwing exceptions. See also 
exception handling 
classes for, 312-317 
re-throwing, 319-322 
time function limitations, 149 
to-do list for class improvements, 
290 

tracing. See also logging 

adding after the fact, 380-386 
building into applications, 

375- 380 
caveats for insertion 

programs, 380 
debugFl owTracer class for, 

376- 377 

debugFl owTracerManager class 

for, 377-379 
need for, 375 

testing the flow trace system, 
379-380 
Tracker class 

creating, 304-305 
testing, 305-306 
trailing spaces. See white space 
transform function 
described, 349-350 
implementing to convert 

strings, 350-351 
operator method called by, 351 
Stri ngConvertTo LowerCase 

class and, 351 
testing the string conversion, 
351-353 
translate. txt file, 282 
translation. See also conversion; 
encryption 
hash table uses for, 279 
Transl ator class, 279-282 



Transl ator class 
creating, 279-281 
testing, 281-282 
translate. txt file for, 282 
two-dimensional arrays, 222 
typeface conventions in this 

book, 2-3 
types. See also constants 
casting to an object, 408 
const constructs as 

type-safe, 46 
converting with casts, 90-95 
creating new types, 63-69 
defining default arguments 

and, 101-106 
encapsulating types and 

rules, 142 
enumerations, 70-72 
extending basic types, 59-62 
for hiding implementation 

from user, 1 1 
identifying and validating for 

applications, 142 
pointers to member functions 

and, 96-100 
scoping variables, 82-84 
s i zeof function and, 52 
stream components and, 225 
structures, 73-76 
as template arguments, 

184-185 
template functions and, 189 
temporary objects and, 408 
using namespaces, 85-89 
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undo method, 418, 419 

uni std . h header file (Unix), 39 

unit tests versus complete 
tests, 115 

unLock method of Lock class, 422 

updating 

benefits of encapsulation for, 10 
encapsulated class, 10-1 1 

uppercase. See case 



URLCodec class 
creating, 338-340 
decode method, 339-340, 341 
encode method, 339, 340, 341 
testing, 340-341 
URLs, rules for, 337 
user name encryption, 343 
using namespace statement, 87 
utilities 

caveats for insertion 

programs, 380 
complex variable utility 

methods, 435-436 
converting the case of a string, 

349-353 
encoding and decoding data 

for the Web, 337-342 
encrypting and decrypting 

strings, 343-348 
generic buffer class, 360-365 
inserting tracing into an exist- 
ing file, 380-386 
keeping a library of utility 

classes, 353 
opening a file using multiple 

paths, 366-371 
serialization interface, 354-359 



validation 

classes for data validation, 

142-148 
Date class code for, 153, 159 
discrete pieces in classes 
for, 159 

documenting data flow and, 419 
for fixed-length input, 452-453 
guardian classes and hardware 

inputs, 425 
missing from standard date 

routines, 149 
optimizing instantiation of 

variables and, 412-413 
Range class for, 60-62 
testing versus, 115 
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DBC, 392-393 
of values, enumerations for, 71 
val^aEJ o^sirsk Jap Date 
) LJfllaaf ^bln\L/j[K^ass 
'application development and, 

142, 149 
defining the Validator obj ect, 

142-143 
generic test drivers for 

validators, 148 
including numeric manipula- 
tion in, 149 
Social Security Number 

validation module, 143-146 
testing, 146-148 
values. See also casts 

class with methods containing 

defaults, 103-106 
enumerations for meaningful 

names, 70 
enumerations for validating, 71 
hard-coded, 30 
initializing for classes or 

structures, 76 
passed to functions, types and, 

90-91, 93-94 
passing by reference, 411-412 
passing objects by, 408 
replacing #def i ne values using 

constants, 77-78 
variables 

complex variable utility 

methods, 435-436 
constants versus basic integer 

variables, 59 
implementing constant 

variables, 78-80 
optimizing instantiation of, 

412-413 
postponing declarations, 

412-413 
scoping, 82-84 
templates as member 

variables, 179 
verifying that value falls within 

a range, 60-62 



vector algorithms 

benefits of, 200 

output from the program, 203 

program using, 201-202 
vector class (STL) 

algorithms, 200-203 

arrays of objects using, 
209-212 

data manipulation in vector 
by, 212 

defining array of objects, 
210, 211 

overhead from, 192, 195, 209 

overview, 25, 192 

printing arrays using streams, 
226-227 

single function using multiple 
algorithms, 203 

using, 192-195 
vectors. See arrays 
virtual destructors. See also 
destructors 

for base classes, 22, 25 

for Compl ete class, 109 

described, 22 

in Fruit class, 22 

in Properties class, 24, 25 

required for Compl ete class, 111 
virtual files 

algorithm, 280, 290 

benefits of, 283 

configurable chunk size for, 290 
creating a virtual file class, 

283-288 
defined, 283 

improving the virtual file 

class, 290 
memory and speed conserved 

by, 283 
pre-loading chunks, 290 
testing the virtual file class, 

289-290 
virtual inheritance 

correcting the code, 119 
defined, 117 
implementing, 118-119 
virtual methods and, 119 



virtual methods. See also pure 
virtual methods 
base class for, 20 
in Col umn class for spread- 
sheet, 217, 218 
customizing a class with, 19-22 
defined, 19 

derived classes and, 23 
factory pattern and, 162 
getCl assName, 357 
getEl ements, 357 
main driver for, 21 
not allowed in structures, 74 
overhead for, 21 
overriding classes, 19, 21, 

162-167 
pure virtual methods versus, 

19, 354 
size of classes and, 54 
testing, 21-22 

using whenever possible, 19 
virtual inheritance and, 119 
v-table for, 21,22, 23, 54 

Visual Studio C++ compiler, 2 

void pointers, 175, 176 

v-tables 

derived classes and, 23 
missing from structures, 74, 76 
section of classes for, 23 
size of classes and, 54 
for virtual methods, 21, 22, 23 
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Web. See companion Web site for 
this book; Internet, the; 
URLCodec class 
white space 

application accountability 

for, 246 
code for removing, 246-248 
output from program for 

removing, 248 
passwords and, 246 
removing from input, 246-249 
testing the application, 249 
width method for streams, 227 
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asterisk (*), 330 
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ower of, 330-331 



question mark (?), 330-331 

uses for, 330-331 
word-parser program 

componentizing, 449-451 

input file for, 449 

source-code listing, 448-449 

specialization, 452-453 
words, converting numbers to. 
See converting numbers to 
words 

World Wide Web. See companion 
Web site for this book; 
Internet, the; URLCodec class 



wrapping 

pointers in auto_ptr template 

object, 303-305 
potentially unsafe code in 
guardian classes, 425-431 
wri te member method, 356-357 



XML (extended Markup 

Language). See also delimited 
files 

class structure compared to, 

240- 241 

creating the XMLWriter class, 

241- 243 

delimited files using, 234 
general format of structures, 
240 



importance of capability for 

output as, 240 
testing the XMLWriter class, 
243-245 

XMLE1 ement class, 241-242, 245 

XMLElement objects, 243 

XMLSuperCl ass class, 244, 245 

XMLWri ter class 
creating, 241-243 
testing, 243-245 
XMLElement objects, 243 

XOR encryption algorithm, 343, 
346-348 

xor operation, strings and, 348 

XOREncrypti on class 

algorithm described, 346 
do_xor method, 346, 347 
implementing, 346-347 
strings and xor operation, 348 
testing, 347-348 
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g Fine-Tuning Your Acting Performance on Film 
Q) Finding Ihe Ported Screenplay tor Your Film 
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Get smart @ dummies.com 

• Find a full list of Dummies titles 

• Look into loads of FREE on-site articles 

• Sign up for FREE eTips e-mailed to you weekly 

• See what other products carry the Dummies name 

• Shop directly from the Dummies bookstore 

• Enter to win new prizes every month! 



* Separate Canadian edition also available 
t Separate U.K. edition also available 

Available wherever books are sold. For more information or to order direct: U.S. customers visit www.dummies.com or call 1-877-762-2974. 
U.K. customers visit www.wileyeurope.com or call 0800 243407. Canadian customers visit www.wiley.ca or call 1 -800-567-4797. 




Do More with Dummies 

Products for the Rest of Us! 




Check out the Dummies Specialty Shop at www.dummies.com for more information! 



